@office-iss/react-native-win32 0.0.0-canary.291 → 0.0.0-canary.292

package/Libraries/Components/ToastAndroid/ToastAndroid.ios.js

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @flow strict-local
+ */
+
+import ToastAndroidFallback from './ToastAndroidFallback';
+
+export default ToastAndroidFallback;

package/Libraries/Components/ToastAndroid/ToastAndroid.js

@@ -8,38 +8,10 @@
  * @flow strict-local
  */
 
-'use strict';
+// NOTE: This file supports backwards compatibility of subpath (deep) imports
+// from 'react-native' with platform-specific extensions. It can be deleted
+// once we remove the "./*" mapping from package.json "exports".
 
-const ToastAndroid = {
-  // Dummy fallback toast duration constants
-  SHORT: (0: number),
-  LONG: (0: number),
-  // Dummy fallback toast gravity constants
-  TOP: (0: number),
-  BOTTOM: (0: number),
-  CENTER: (0: number),
-
-  show: function (message: string, duration: number): void {
-    console.warn('ToastAndroid is not supported on this platform.');
-  },
-
-  showWithGravity: function (
-    message: string,
-    duration: number,
-    gravity: number,
-  ): void {
-    console.warn('ToastAndroid is not supported on this platform.');
-  },
-
-  showWithGravityAndOffset: function (
-    message: string,
-    duration: number,
-    gravity: number,
-    xOffset: number,
-    yOffset: number,
-  ): void {
-    console.warn('ToastAndroid is not supported on this platform.');
-  },
-};
+import ToastAndroid from './ToastAndroid';
 
 export default ToastAndroid;

package/Libraries/Components/ToastAndroid/ToastAndroid.js.flow

@@ -0,0 +1,109 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @flow strict-local
+ */
+
+/**
+ * This exposes the native ToastAndroid module as a JS module. This has a function 'show'
+ * which takes the following parameters:
+ *
+ * 1. String message: A string with the text to toast
+ * 2. int duration: The duration of the toast. May be ToastAndroid.SHORT or ToastAndroid.LONG
+ *
+ * There is also a function `showWithGravity` to specify the layout gravity. May be
+ * ToastAndroid.TOP, ToastAndroid.BOTTOM, ToastAndroid.CENTER
+ *
+ * **Note**: Starting from Android API level 30 (Android R) or higher, for apps targeting
+ * that API level, setting toast gravity is a no-op for text toasts.
+ * This means that in many cases `TOP`, `BOTTOM`, `CENTER`, or offsets may not have
+ * any visible effect on actual toast positioning.
+ *
+ * Reference: https://developer.android.com/reference/android/widget/Toast#setGravity(int,%20int,%20int)
+ */
+declare const ToastAndroid: {
+  /**
+   * Indicates a short duration on the screen.
+   *
+   * Value: 2000 milliseconds (2 seconds).
+   */
+  SHORT: number,
+
+  /**
+   * Indicates a long duration on the screen.
+   *
+   * Value: 3500 milliseconds (3.5 seconds).
+   */
+  LONG: number,
+
+  /**
+   * Indicates that the toast message should appear at the top of the screen.
+   *
+   * **Note**: On Android R or later, this may not have any visible effect.
+   */
+  TOP: number,
+
+  /**
+   * Indicates that the toast message should appear at the bottom of the screen.
+   *
+   * **Note**: On Android R or later, this may not have any visible effect.
+   */
+  BOTTOM: number,
+
+  /**
+   * Indicates that the toast message should appear at the center of the screen.
+   *
+   * **Note**: On Android R or later, this may not have any visible effect.
+   */
+  CENTER: number,
+
+  /**
+   * Display a toast message for a specified duration.
+   *
+   * @param message A string with the text to toast.
+   * @param duration The duration of the toast–either ToastAndroid.SHORT or ToastAndroid.LONG
+   */
+  show: (message: string, duration: number) => void,
+
+  /**
+   * Display a toast message for a specified duration with a given gravity.
+   *
+   * @param message A string with the text to display in the toast.
+   * @param duration The duration of the toast.
+   *                 May be `ToastAndroid.SHORT` or `ToastAndroid.LONG`.
+   * @param gravity Positioning on the screen, e.g.,
+   *                `ToastAndroid.TOP`, `ToastAndroid.BOTTOM`, or `ToastAndroid.CENTER`.
+   *
+   * **Note**: On Android R (API 30) or later (when targeting API 30+), this setting may
+   * not have any effect on text toast placement due to `setGravity` becoming a no-op.
+   */
+  showWithGravity: (message: string, duration: number, gravity: number) => void,
+
+  /**
+   * Display a toast message for a specified duration with a given gravity and custom offsets.
+   *
+   * @param message A string with the text to display in the toast.
+   * @param duration The duration of the toast.
+   *                 May be `ToastAndroid.SHORT` or `ToastAndroid.LONG`.
+   * @param gravity Positioning on the screen, e.g.,
+   *                `ToastAndroid.TOP`, `ToastAndroid.BOTTOM`, or `ToastAndroid.CENTER`.
+   * @param xOffset Horizontal offset from the given gravity.
+   * @param yOffset Vertical offset from the given gravity.
+   *
+   * **Note**: On Android R (API 30) or later (when targeting API 30+), setting gravity
+   * and offsets may not visibly affect the placement of text toasts.
+   */
+  showWithGravityAndOffset: (
+    message: string,
+    duration: number,
+    gravity: number,
+    xOffset: number,
+    yOffset: number,
+  ) => void,
+};
+
+export default ToastAndroid;

package/Libraries/Components/ToastAndroid/ToastAndroid.win32.js

@@ -8,38 +8,10 @@
  * @flow strict-local
  */
 
-'use strict';
+// NOTE: This file supports backwards compatibility of subpath (deep) imports
+// from 'react-native' with platform-specific extensions. It can be deleted
+// once we remove the "./*" mapping from package.json "exports".
 
-const ToastAndroid = {
-  // Dummy fallback toast duration constants
-  SHORT: (0: number),
-  LONG: (0: number),
-  // Dummy fallback toast gravity constants
-  TOP: (0: number),
-  BOTTOM: (0: number),
-  CENTER: (0: number),
-
-  show: function (message: string, duration: number): void {
-    console.warn('ToastAndroid is not supported on this platform.');
-  },
-
-  showWithGravity: function (
-    message: string,
-    duration: number,
-    gravity: number,
-  ): void {
-    console.warn('ToastAndroid is not supported on this platform.');
-  },
-
-  showWithGravityAndOffset: function (
-    message: string,
-    duration: number,
-    gravity: number,
-    xOffset: number,
-    yOffset: number,
-  ): void {
-    console.warn('ToastAndroid is not supported on this platform.');
-  },
-};
+import ToastAndroid from './ToastAndroid';
 
 export default ToastAndroid;

package/Libraries/Components/ToastAndroid/ToastAndroidFallback.js

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @flow strict-local
+ */
+
+'use strict';
+
+const ToastAndroid = {
+  // Dummy fallback toast duration constants
+  SHORT: (0: number),
+  LONG: (0: number),
+  // Dummy fallback toast gravity constants
+  TOP: (0: number),
+  BOTTOM: (0: number),
+  CENTER: (0: number),
+
+  show: function (message: string, duration: number): void {
+    console.warn('ToastAndroid is not supported on this platform.');
+  },
+
+  showWithGravity: function (
+    message: string,
+    duration: number,
+    gravity: number,
+  ): void {
+    console.warn('ToastAndroid is not supported on this platform.');
+  },
+
+  showWithGravityAndOffset: function (
+    message: string,
+    duration: number,
+    gravity: number,
+    xOffset: number,
+    yOffset: number,
+  ): void {
+    console.warn('ToastAndroid is not supported on this platform.');
+  },
+};
+
+export default ToastAndroid;

package/Libraries/Components/Touchable/Touchable.js

@@ -144,7 +144,7 @@ const States = {
   ERROR: 'ERROR',
 };
 
-type State =
+type TouchableState =
   | typeof States.NOT_RESPONDER
   | typeof States.RESPONDER_INACTIVE_PRESS_IN
   | typeof States.RESPONDER_INACTIVE_PRESS_OUT
@@ -397,7 +397,7 @@ const TouchableMixinImpl = {
    */
   touchableGetInitialState: function (): {
     touchable: {
-      touchState: ?State,
+      touchState: ?TouchableState,
       responderID: ?GestureResponderEvent['currentTarget'],
     },
   } {
@@ -806,7 +806,7 @@ const TouchableMixinImpl = {
     this.longPressDelayTimeout = null;
   },
 
-  _isHighlight: function (state: State): boolean {
+  _isHighlight: function (state: TouchableState): boolean {
     return (
       state === States.RESPONDER_ACTIVE_PRESS_IN ||
       state === States.RESPONDER_ACTIVE_LONG_PRESS_IN
@@ -849,8 +849,8 @@ const TouchableMixinImpl = {
   /* $FlowFixMe[missing-this-annot] The 'this' type annotation(s) required by
    * Flow's LTI update could not be added via codemod */
   _performSideEffectsForTransition: function (
-    curState: State,
-    nextState: State,
+    curState: TouchableState,
+    nextState: TouchableState,
     signal: Signal,
     e: GestureResponderEvent,
   ) {

package/Libraries/Components/Touchable/Touchable.win32.js

@@ -149,7 +149,7 @@ const States = {
   ERROR: 'ERROR',
 };
 
-type State =
+type TouchableState =
   | typeof States.NOT_RESPONDER
   | typeof States.RESPONDER_INACTIVE_PRESS_IN
   | typeof States.RESPONDER_INACTIVE_PRESS_OUT
@@ -402,7 +402,7 @@ const TouchableMixinImpl = {
    */
   touchableGetInitialState: function (): {
     touchable: {
-      touchState: ?State,
+      touchState: ?TouchableState,
       responderID: ?GestureResponderEvent['currentTarget'],
     },
   } {
@@ -811,7 +811,7 @@ const TouchableMixinImpl = {
     this.longPressDelayTimeout = null;
   },
 
-  _isHighlight: function (state: State): boolean {
+  _isHighlight: function (state: TouchableState): boolean {
     return (
       state === States.RESPONDER_ACTIVE_PRESS_IN ||
       state === States.RESPONDER_ACTIVE_LONG_PRESS_IN
@@ -854,8 +854,8 @@ const TouchableMixinImpl = {
   /* $FlowFixMe[missing-this-annot] The 'this' type annotation(s) required by
    * Flow's LTI update could not be added via codemod */
   _performSideEffectsForTransition: function (
-    curState: State,
-    nextState: State,
+    curState: TouchableState,
+    nextState: TouchableState,
     signal: Signal,
     e: GestureResponderEvent,
   ) {

package/Libraries/Components/Touchable/TouchableBounce.js

@@ -19,7 +19,7 @@ import {PressabilityDebugView} from '../../Pressability/PressabilityDebug';
 import Platform from '../../Utilities/Platform';
 import * as React from 'react';
 
-type Props = $ReadOnly<{
+type TouchableBounceProps = $ReadOnly<{
   ...React.ElementConfig<TouchableWithoutFeedback>,
 
   onPressAnimationComplete?: ?() => void,
@@ -31,13 +31,16 @@ type Props = $ReadOnly<{
   hostRef: React.RefSetter<React.ElementRef<typeof Animated.View>>,
 }>;
 
-type State = $ReadOnly<{
+type TouchableBounceState = $ReadOnly<{
   pressability: Pressability,
   scale: Animated.Value,
 }>;
 
-class TouchableBounce extends React.Component<Props, State> {
-  state: State = {
+class TouchableBounce extends React.Component<
+  TouchableBounceProps,
+  TouchableBounceState,
+> {
+  state: TouchableBounceState = {
     pressability: new Pressability(this._createPressabilityConfig()),
     scale: new Animated.Value(1),
   };
@@ -201,7 +204,10 @@ class TouchableBounce extends React.Component<Props, State> {
     );
   }
 
-  componentDidUpdate(prevProps: Props, prevState: State) {
+  componentDidUpdate(
+    prevProps: TouchableBounceProps,
+    prevState: TouchableBounceState,
+  ) {
     this.state.pressability.configure(this._createPressabilityConfig());
   }
 
@@ -219,5 +225,5 @@ export default (React.forwardRef((props, hostRef: React.RefSetter<mixed>) => (
   <TouchableBounce {...props} hostRef={hostRef} />
 )): component(
   ref: React.RefSetter<mixed>,
-  ...props: $ReadOnly<$Diff<Props, {hostRef: mixed}>>
+  ...props: $ReadOnly<Omit<TouchableBounceProps, 'hostRef'>>
 ));

package/Libraries/Components/Touchable/TouchableHighlight.js

@@ -55,7 +55,7 @@ type TouchableHighlightBaseProps = $ReadOnly<{
   onHideUnderlay?: ?() => void,
   testOnly_pressed?: ?boolean,
 
-  hostRef: React.RefSetter<React.ElementRef<typeof View>>,
+  hostRef?: React.RefSetter<React.ElementRef<typeof View>>,
 }>;
 
 export type TouchableHighlightProps = $ReadOnly<{
@@ -70,7 +70,7 @@ type ExtraStyles = $ReadOnly<{
   underlay: ViewStyleProp,
 }>;
 
-type State = $ReadOnly<{
+type TouchableHighlightState = $ReadOnly<{
   pressability: Pressability,
   extraStyles: ?ExtraStyles,
 }>;
@@ -173,12 +173,12 @@ type State = $ReadOnly<{
  */
 class TouchableHighlightImpl extends React.Component<
   TouchableHighlightProps,
-  State,
+  TouchableHighlightState,
 > {
   _hideTimeout: ?TimeoutID;
   _isMounted: boolean = false;
 
-  state: State = {
+  state: TouchableHighlightState = {
     pressability: new Pressability(this._createPressabilityConfig()),
     extraStyles:
       this.props.testOnly_pressed === true ? this._createExtraStyles() : null,
@@ -389,7 +389,10 @@ class TouchableHighlightImpl extends React.Component<
     this.state.pressability.configure(this._createPressabilityConfig());
   }
 
-  componentDidUpdate(prevProps: TouchableHighlightProps, prevState: State) {
+  componentDidUpdate(
+    prevProps: TouchableHighlightProps,
+    prevState: TouchableHighlightState,
+  ) {
     this.state.pressability.configure(this._createPressabilityConfig());
   }
 
@@ -404,7 +407,7 @@ class TouchableHighlightImpl extends React.Component<
 
 const TouchableHighlight: component(
   ref?: React.RefSetter<React.ElementRef<typeof View>>,
-  ...props: $ReadOnly<$Diff<TouchableHighlightProps, {+hostRef: mixed}>>
+  ...props: $ReadOnly<Omit<TouchableHighlightProps, 'hostRef'>>
 ) = React.forwardRef((props, hostRef) => (
   <TouchableHighlightImpl {...props} hostRef={hostRef} />
 ));

package/Libraries/Components/Touchable/TouchableNativeFeedback.js

@@ -112,7 +112,7 @@ export type TouchableNativeFeedbackProps = $ReadOnly<{
   useForeground?: ?boolean,
 }>;
 
-type State = $ReadOnly<{
+type TouchableNativeFeedbackState = $ReadOnly<{
   pressability: Pressability,
 }>;
 
@@ -128,7 +128,7 @@ type State = $ReadOnly<{
  */
 class TouchableNativeFeedback extends React.Component<
   TouchableNativeFeedbackProps,
-  State,
+  TouchableNativeFeedbackState,
 > {
   /**
    * Creates an object that represents android theme's default background for
@@ -204,7 +204,7 @@ class TouchableNativeFeedback extends React.Component<
   static canUseNativeForeground: () => boolean = () =>
     Platform.OS === 'android';
 
-  state: State = {
+  state: TouchableNativeFeedbackState = {
     pressability: new Pressability(this._createPressabilityConfig()),
   };
 
@@ -383,7 +383,7 @@ class TouchableNativeFeedback extends React.Component<
 
   componentDidUpdate(
     prevProps: TouchableNativeFeedbackProps,
-    prevState: State,
+    prevState: TouchableNativeFeedbackState,
   ) {
     this.state.pressability.configure(this._createPressabilityConfig());
   }

package/Libraries/Components/Touchable/TouchableNativeFeedback.win32.js

@@ -111,7 +111,7 @@ export type TouchableNativeFeedbackProps = $ReadOnly<{
   tooltip?: string, // Win32
 }>;
 
-type State = $ReadOnly<{
+type TouchableNativeFeedbackState = $ReadOnly<{
   pressability: Pressability,
 }>;
 
@@ -127,7 +127,7 @@ type State = $ReadOnly<{
  */
 class TouchableNativeFeedback extends React.Component<
   TouchableNativeFeedbackProps,
-  State,
+  TouchableNativeFeedbackState,
 > {
   /**
    * Creates an object that represents android theme's default background for
@@ -203,7 +203,7 @@ class TouchableNativeFeedback extends React.Component<
   static canUseNativeForeground: () => boolean = () =>
     Platform.OS === 'android';
 
-  state: State = {
+  state: TouchableNativeFeedbackState = {
     pressability: new Pressability(this._createPressabilityConfig()),
   };
 
@@ -285,7 +285,7 @@ class TouchableNativeFeedback extends React.Component<
 
   componentDidUpdate(
     prevProps: TouchableNativeFeedbackProps,
-    prevState: State,
+    prevState: TouchableNativeFeedbackState,
   ) {
     this.state.pressability.configure(this._createPressabilityConfig());
   }

package/Libraries/Components/Touchable/TouchableOpacity.js

@@ -71,7 +71,7 @@ type TouchableOpacityBaseProps = $ReadOnly<{
    * Defaults to 0.2
    */
   activeOpacity?: ?number,
-  style?: ?ViewStyleProp,
+  style?: ?Animated.WithAnimatedValue<ViewStyleProp>,
 
   hostRef?: ?React.RefSetter<React.ElementRef<typeof Animated.View>>,
 }>;
@@ -82,7 +82,7 @@ export type TouchableOpacityProps = $ReadOnly<{
   ...TouchableOpacityBaseProps,
 }>;
 
-type State = $ReadOnly<{
+type TouchableOpacityState = $ReadOnly<{
   anim: Animated.Value,
   pressability: Pressability,
 }>;
@@ -171,8 +171,11 @@ type State = $ReadOnly<{
  * ```
  *
  */
-class TouchableOpacity extends React.Component<TouchableOpacityProps, State> {
-  state: State = {
+class TouchableOpacity extends React.Component<
+  TouchableOpacityProps,
+  TouchableOpacityState,
+> {
+  state: TouchableOpacityState = {
     anim: new Animated.Value(this._getChildStyleOpacityWithDefault()),
     pressability: new Pressability(this._createPressabilityConfig()),
   };
@@ -345,7 +348,10 @@ class TouchableOpacity extends React.Component<TouchableOpacityProps, State> {
     );
   }
 
-  componentDidUpdate(prevProps: TouchableOpacityProps, prevState: State) {
+  componentDidUpdate(
+    prevProps: TouchableOpacityProps,
+    prevState: TouchableOpacityState,
+  ) {
     this.state.pressability.configure(this._createPressabilityConfig());
     if (
       this.props.disabled !== prevProps.disabled ||

package/Libraries/Components/View/ViewAccessibility.js

@@ -358,6 +358,13 @@ export type AccessibilityProps = $ReadOnly<{
    */
   'aria-label'?: ?Stringish,
 
+  /**
+   * Defines the order in which descendant elements receive accessibility focus.
+   * The elements in the array represent nativeID values for the respective
+   * descendant elements.
+   */
+  experimental_accessibilityOrder?: ?Array<string>,
+
   /**
    * Indicates to accessibility services to treat UI component like a specific role.
    */

package/Libraries/Components/View/ViewAccessibility.win32.js

@@ -371,6 +371,13 @@ export type AccessibilityProps = $ReadOnly<{
    */
   'aria-label'?: ?Stringish,
 
+  /**
+   * Defines the order in which descendant elements receive accessibility focus.
+   * The elements in the array represent nativeID values for the respective
+   * descendant elements.
+   */
+  experimental_accessibilityOrder?: ?Array<string>,
+
   /**
    * Indicates to accessibility services to treat UI component like a specific role.
    */

package/Libraries/Components/View/ViewPropTypes.js

@@ -26,7 +26,7 @@ import type {
   AccessibilityProps,
 } from './ViewAccessibility';
 
-import React from 'react';
+import * as React from 'react';
 
 export type ViewLayout = LayoutRectangle;
 export type ViewLayoutEvent = LayoutChangeEvent;

package/Libraries/Components/View/ViewPropTypes.win32.js

@@ -27,7 +27,7 @@ import type {
   AccessibilityProps,
 } from './ViewAccessibility';
 
-import React from 'react';
+import * as React from 'react';
 
 export type ViewLayout = LayoutRectangle;
 export type ViewLayoutEvent = LayoutChangeEvent;

package/Libraries/Core/ReactNativeVersion.js

@@ -17,5 +17,5 @@ export const version: $ReadOnly<{
   major: 0,
   minor: 80,
   patch: 0,
-  prerelease: 'nightly-20250331-398ac1f71',
+  prerelease: 'nightly-20250414-70cdf12c4',
 };

package/Libraries/EventEmitter/NativeEventEmitter.js

@@ -24,7 +24,10 @@ interface NativeModule {
   removeListeners(count: number): void;
 }
 
-export type {EventSubscription};
+/** @deprecated Use `EventSubscription` instead. */
+type EmitterSubscription = EventSubscription;
+
+export type {EventSubscription, EmitterSubscription};
 /** @deprecated Use `EventSubscription` instead. */
 export type NativeEventSubscription = EventSubscription;
 

package/Libraries/Image/Image.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+// NOTE: This file supports backwards compatibility of subpath (deep) imports
+// from 'react-native' with platform-specific extensions. It can be deleted
+// once we remove the "./*" mapping from package.json "exports".
+
+import Image from './Image';
+
+export default Image;

package/Libraries/Image/Image.js.flow

@@ -8,7 +8,7 @@
  * @format
  */
 
-import type {Image} from './ImageTypes.flow';
+import type {ImageType} from './ImageTypes.flow';
 
 export type {
   ImageProgressEventIOS,
@@ -24,4 +24,4 @@ export type {
 
 export type {ImageResolvedAssetSource, ImageSize} from './ImageTypes.flow';
 
-declare export default Image;
+declare export default ImageType;

package/Libraries/Image/ImageInjection.js

@@ -11,7 +11,7 @@
 import type {
   AbstractImageAndroid,
   AbstractImageIOS,
-  Image as ImageComponent,
+  ImageType as ImageComponent,
 } from './ImageTypes.flow';
 
 import useMergeRefs from '../Utilities/useMergeRefs';