@office-iss/react-native-win32 0.70.2 → 0.71.0-preview.1

package/Libraries/Components/Slider/Slider.d.ts

@@ -0,0 +1,132 @@
+/**
+ * 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
+ */
+
+import type * as React from 'react';
+import {Constructor} from '../../../types/private/Utilities';
+import {ImageURISource} from '../../Image/ImageSource';
+import {NativeMethods} from '../../../types/public/ReactNativeTypes';
+import {ColorValue, StyleProp} from '../../StyleSheet/StyleSheet';
+import {ViewStyle} from '../../StyleSheet/StyleSheetTypes';
+import {ViewProps} from '../View/ViewPropTypes';
+
+export interface SliderPropsAndroid extends ViewProps {
+  /**
+   * Color of the foreground switch grip.
+   */
+  thumbTintColor?: ColorValue | undefined;
+}
+
+export interface SliderPropsIOS extends ViewProps {
+  /**
+   * Assigns a maximum track image. Only static images are supported.
+   * The leftmost pixel of the image will be stretched to fill the track.
+   */
+  maximumTrackImage?: ImageURISource | undefined;
+
+  /**
+   * Assigns a minimum track image. Only static images are supported.
+   * The rightmost pixel of the image will be stretched to fill the track.
+   */
+  minimumTrackImage?: ImageURISource | undefined;
+
+  /**
+   * Sets an image for the thumb. Only static images are supported.
+   */
+  thumbImage?: ImageURISource | undefined;
+
+  /**
+   * Assigns a single image for the track. Only static images
+   * are supported. The center pixel of the image will be stretched
+   * to fill the track.
+   */
+  trackImage?: ImageURISource | undefined;
+}
+
+export interface SliderProps extends SliderPropsIOS, SliderPropsAndroid {
+  /**
+   * If true the user won't be able to move the slider.
+   * Default value is false.
+   */
+  disabled?: boolean | undefined;
+
+  /**
+   * The color used for the track to the right of the button.
+   * Overrides the default blue gradient image.
+   */
+  maximumTrackTintColor?: ColorValue | undefined;
+
+  /**
+   * Initial maximum value of the slider. Default value is 1.
+   */
+  maximumValue?: number | undefined;
+
+  /**
+   * The color used for the track to the left of the button.
+   * Overrides the default blue gradient image.
+   */
+  minimumTrackTintColor?: ColorValue | undefined;
+
+  /**
+   * Initial minimum value of the slider. Default value is 0.
+   */
+  minimumValue?: number | undefined;
+
+  /**
+   * Callback called when the user finishes changing the value (e.g. when the slider is released).
+   */
+  onSlidingComplete?: ((value: number) => void) | undefined;
+
+  /**
+   * Callback continuously called while the user is dragging the slider.
+   */
+  onValueChange?: ((value: number) => void) | undefined;
+
+  /**
+   * Step value of the slider. The value should be between 0 and (maximumValue - minimumValue). Default value is 0.
+   */
+  step?: number | undefined;
+
+  /**
+   * Used to style and layout the Slider. See StyleSheet.js for more info.
+   */
+  style?: StyleProp<ViewStyle> | undefined;
+
+  /**
+   * Used to locate this view in UI automation tests.
+   */
+  testID?: string | undefined;
+
+  /**
+   * Initial value of the slider. The value should be between minimumValue
+   * and maximumValue, which default to 0 and 1 respectively.
+   * Default value is 0.
+   * This is not a controlled component, you don't need to update
+   * the value during dragging.
+   */
+  value?: number | undefined;
+}
+
+/**
+ * A component used to select a single value from a range of values.
+ */
+declare class SliderComponent extends React.Component<SliderProps> {}
+declare const SliderBase: Constructor<NativeMethods> & typeof SliderComponent;
+/**
+ * Slider has been extracted from react-native core and will be removed in a future release.
+ * It can now be installed and imported from `@react-native-community/slider` instead of 'react-native'.
+ * @see https://github.com/callstack/react-native-slider
+ * @deprecated
+ */
+export class Slider extends SliderBase {}
+/**  SliderIOS has been removed from react-native.
+ * It can now be installed and imported from `@react-native-community/slider` instead of 'react-native'.
+ * @see https://github.com/callstack/react-native-slider
+ * @deprecated
+ */
+export type SliderIOS = Slider;

package/Libraries/Components/Slider/Slider.js

@@ -8,18 +8,18 @@
  * @flow strict-local
  */
 
-import * as React from 'react';
-import Platform from '../../Utilities/Platform';
-import SliderNativeComponent from './SliderNativeComponent';
-import StyleSheet, {
-  type ViewStyleProp,
-  type ColorValue,
-} from '../../StyleSheet/StyleSheet';
-
 import type {ImageSource} from '../../Image/ImageSource';
-import type {ViewProps} from '../View/ViewPropTypes';
 import type {SyntheticEvent} from '../../Types/CoreEventTypes';
 import type {AccessibilityState} from '../View/ViewAccessibility';
+import type {ViewProps} from '../View/ViewPropTypes';
+
+import StyleSheet, {
+  type ColorValue,
+  type ViewStyleProp,
+} from '../../StyleSheet/StyleSheet';
+import Platform from '../../Utilities/Platform';
+import SliderNativeComponent from './SliderNativeComponent';
+import * as React from 'react';
 
 type Event = SyntheticEvent<
   $ReadOnly<{|

package/Libraries/Components/Slider/SliderNativeComponent.js

@@ -8,19 +8,18 @@
  * @flow strict-local
  */
 
+import type {ImageSource} from '../../Image/ImageSource';
+import type {HostComponent} from '../../Renderer/shims/ReactNativeTypes';
+import type {ColorValue} from '../../StyleSheet/StyleSheet';
 import type {
   BubblingEventHandler,
   DirectEventHandler,
   Double,
   WithDefault,
 } from '../../Types/CodegenTypes';
+import type {ViewProps} from '../View/ViewPropTypes';
 
 import codegenNativeComponent from '../../Utilities/codegenNativeComponent';
-import type {HostComponent} from '../../Renderer/shims/ReactNativeTypes';
-
-import type {ColorValue} from '../../StyleSheet/StyleSheet';
-import type {ImageSource} from '../../Image/ImageSource';
-import type {ViewProps} from '../View/ViewPropTypes';
 
 type Event = $ReadOnly<{|
   value: Double,

package/Libraries/Components/Sound/NativeSoundManager.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../../TurboModule/TurboModuleRegistry';
 
 /**

package/Libraries/Components/StatusBar/NativeStatusBarManagerAndroid.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../../TurboModule/TurboModuleRegistry';
 
 export interface Spec extends TurboModule {

package/Libraries/Components/StatusBar/NativeStatusBarManagerIOS.js

@@ -9,6 +9,7 @@
  */
 
 import type {TurboModule} from '../../TurboModule/RCTExport';
+
 import * as TurboModuleRegistry from '../../TurboModule/TurboModuleRegistry';
 
 export interface Spec extends TurboModule {

package/Libraries/Components/StatusBar/StatusBar.d.ts

@@ -0,0 +1,138 @@
+/**
+ * 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
+ */
+
+import type * as React from 'react';
+import {ColorValue} from '../../StyleSheet/StyleSheet';
+
+export type StatusBarStyle = 'default' | 'light-content' | 'dark-content';
+
+export type StatusBarAnimation = 'none' | 'fade' | 'slide';
+
+export interface StatusBarPropsIOS {
+  /**
+   * If the network activity indicator should be visible.
+   *
+   * @platform ios
+   */
+  networkActivityIndicatorVisible?: boolean | undefined;
+
+  /**
+   * The transition effect when showing and hiding the status bar using
+   * the hidden prop. Defaults to 'fade'.
+   *
+   * @platform ios
+   */
+  showHideTransition?: null | 'fade' | 'slide' | 'none' | undefined;
+}
+
+export interface StatusBarPropsAndroid {
+  /**
+   * The background color of the status bar.
+   *
+   * @platform android
+   */
+  backgroundColor?: ColorValue | undefined;
+
+  /**
+   * If the status bar is translucent. When translucent is set to true,
+   * the app will draw under the status bar. This is useful when using a
+   * semi transparent status bar color.
+   *
+   * @platform android
+   */
+  translucent?: boolean | undefined;
+}
+
+export interface StatusBarProps
+  extends StatusBarPropsIOS,
+    StatusBarPropsAndroid {
+  /**
+   * If the transition between status bar property changes should be
+   * animated. Supported for backgroundColor, barStyle and hidden.
+   */
+  animated?: boolean | undefined;
+
+  /**
+   * Sets the color of the status bar text.
+   */
+  barStyle?: null | StatusBarStyle | undefined;
+
+  /**
+   * If the status bar is hidden.
+   */
+  hidden?: boolean | undefined;
+}
+
+export class StatusBar extends React.Component<StatusBarProps> {
+  /**
+   * The current height of the status bar on the device.
+   * @platform android
+   */
+  static currentHeight?: number | undefined;
+
+  /**
+   * Show or hide the status bar
+   * @param hidden The dialog's title.
+   * @param animation Optional animation when
+   *    changing the status bar hidden property.
+   */
+  static setHidden: (hidden: boolean, animation?: StatusBarAnimation) => void;
+
+  /**
+   * Set the status bar style
+   * @param style Status bar style to set
+   * @param animated Animate the style change.
+   */
+  static setBarStyle: (style: StatusBarStyle, animated?: boolean) => void;
+
+  /**
+   * Control the visibility of the network activity indicator
+   * @param visible Show the indicator.
+   */
+  static setNetworkActivityIndicatorVisible: (visible: boolean) => void;
+
+  /**
+   * Set the background color for the status bar
+   * @param color Background color.
+   * @param animated Animate the style change.
+   */
+  static setBackgroundColor: (color: ColorValue, animated?: boolean) => void;
+
+  /**
+   * Control the translucency of the status bar
+   * @param translucent Set as translucent.
+   */
+  static setTranslucent: (translucent: boolean) => void;
+
+  /**
+   * Push a StatusBar entry onto the stack.
+   * The return value should be passed to `popStackEntry` when complete.
+   *
+   * @param props Object containing the StatusBar props to use in the stack entry.
+   */
+  static pushStackEntry: (props: StatusBarProps) => StatusBarProps;
+
+  /**
+   * Pop a StatusBar entry from the stack.
+   *
+   * @param entry Entry returned from `pushStackEntry`.
+   */
+  static popStackEntry: (entry: StatusBarProps) => void;
+
+  /**
+   * Replace an existing StatusBar stack entry with new props.
+   *
+   * @param entry Entry returned from `pushStackEntry` to replace.
+   * @param props Object containing the StatusBar props to use in the replacement stack entry.
+   */
+  static replaceStackEntry: (
+    entry: StatusBarProps,
+    props: StatusBarProps,
+  ) => StatusBarProps;
+}

package/Libraries/Components/StatusBar/StatusBar.js

@@ -8,14 +8,14 @@
  * @flow
  */
 
-import * as React from 'react';
-import Platform from '../../Utilities/Platform';
-import invariant from 'invariant';
-import processColor from '../../StyleSheet/processColor';
 import type {ColorValue} from '../../StyleSheet/StyleSheet';
 
+import processColor from '../../StyleSheet/processColor';
+import Platform from '../../Utilities/Platform';
 import NativeStatusBarManagerAndroid from './NativeStatusBarManagerAndroid';
 import NativeStatusBarManagerIOS from './NativeStatusBarManagerIOS';
+import invariant from 'invariant';
+import * as React from 'react';
 
 /**
  * Status bar style
@@ -223,9 +223,9 @@ function createStackEntry(props: any): any {
  * `currentHeight` (Android only) The height of the status bar.
  */
 class StatusBar extends React.Component<Props> {
-  static _propsStack = [];
+  static _propsStack: Array<any> = [];
 
-  static _defaultProps = createStackEntry({
+  static _defaultProps: any = createStackEntry({
     backgroundColor:
       Platform.OS === 'android'
         ? NativeStatusBarManagerAndroid.getConstants()
@@ -309,7 +309,7 @@ class StatusBar extends React.Component<Props> {
    * @param color Background color.
    * @param animated Animate the style change.
    */
-  static setBackgroundColor(color: string, animated?: boolean) {
+  static setBackgroundColor(color: string, animated?: boolean): void {
     if (Platform.OS !== 'android') {
       console.warn('`setBackgroundColor` is only available on Android');
       return;

package/Libraries/Components/Switch/AndroidSwitchNativeComponent.js

@@ -8,22 +8,22 @@
  * @format
  */
 
-import * as React from 'react';
-
+import type {HostComponent} from '../../Renderer/shims/ReactNativeTypes';
+import type {ColorValue} from '../../StyleSheet/StyleSheet';
 import type {
-  WithDefault,
   BubblingEventHandler,
-} from 'react-native/Libraries/Types/CodegenTypes';
-
-import codegenNativeCommands from 'react-native/Libraries/Utilities/codegenNativeCommands';
-import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
-import type {HostComponent} from 'react-native/Libraries/Renderer/shims/ReactNativeTypes';
-
-import type {ColorValue} from '../../StyleSheet/StyleSheet';
+  Int32,
+  WithDefault,
+} from '../../Types/CodegenTypes';
 import type {ViewProps} from '../View/ViewPropTypes';
 
+import codegenNativeCommands from '../../Utilities/codegenNativeCommands';
+import codegenNativeComponent from '../../Utilities/codegenNativeComponent';
+import * as React from 'react';
+
 type SwitchChangeEvent = $ReadOnly<{|
   value: boolean,
+  target: Int32,
 |}>;
 
 type NativeProps = $ReadOnly<{|

package/Libraries/Components/Switch/Switch.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 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
+ */
+
+import type * as React from 'react';
+import {Constructor} from '../../../types/private/Utilities';
+import {NativeMethods} from '../../../types/public/ReactNativeTypes';
+import {ColorValue, StyleProp} from '../../StyleSheet/StyleSheet';
+import {ViewStyle} from '../../StyleSheet/StyleSheetTypes';
+import {ViewProps} from '../View/ViewPropTypes';
+import {NativeSyntheticEvent, TargetedEvent} from '../../Types/CoreEventTypes';
+
+export interface SwitchPropsIOS extends ViewProps {
+  /**
+   * Background color when the switch is turned on.
+   *
+   * @deprecated use trackColor instead
+   */
+  onTintColor?: ColorValue | undefined;
+
+  /**
+   * Color of the foreground switch grip.
+   *
+   * @deprecated use thumbColor instead
+   */
+  thumbTintColor?: ColorValue | undefined;
+
+  /**
+   * Background color when the switch is turned off.
+   *
+   * @deprecated use trackColor instead
+   */
+  tintColor?: ColorValue | undefined;
+}
+
+export interface SwitchChangeEventData extends TargetedEvent {
+  value: boolean;
+}
+
+export interface SwitchChangeEvent
+  extends NativeSyntheticEvent<SwitchChangeEventData> {}
+
+export interface SwitchProps extends SwitchPropsIOS {
+  /**
+   * Color of the foreground switch grip.
+   */
+  thumbColor?: ColorValue | undefined;
+
+  /**
+   * Custom colors for the switch track
+   *
+   * Color when false and color when true
+   */
+  trackColor?:
+    | {
+        false?: ColorValue | null | undefined;
+        true?: ColorValue | null | undefined;
+      }
+    | undefined;
+
+  /**
+   * If true the user won't be able to toggle the switch.
+   * Default value is false.
+   */
+  disabled?: boolean | undefined;
+
+  /**
+   * Invoked with the change event as an argument when the value changes.
+   */
+  onChange?:
+    | ((event: SwitchChangeEvent) => Promise<void> | void)
+    | null
+    | undefined;
+
+  /**
+   * Invoked with the new value when the value changes.
+   */
+  onValueChange?: ((value: boolean) => Promise<void> | void) | null | undefined;
+
+  /**
+   * Used to locate this view in end-to-end tests.
+   */
+  testID?: string | undefined;
+
+  /**
+   * The value of the switch. If true the switch will be turned on.
+   * Default value is false.
+   */
+  value?: boolean | undefined;
+
+  /**
+   * On iOS, custom color for the background.
+   * Can be seen when the switch value is false or when the switch is disabled.
+   */
+  ios_backgroundColor?: ColorValue | undefined;
+
+  style?: StyleProp<ViewStyle> | undefined;
+}
+
+/**
+ * Renders a boolean input.
+ *
+ * This is a controlled component that requires an `onValueChange` callback that
+ * updates the `value` prop in order for the component to reflect user actions.
+ * If the `value` prop is not updated, the component will continue to render
+ * the supplied `value` prop instead of the expected result of any user actions.
+ */
+declare class SwitchComponent extends React.Component<SwitchProps> {}
+declare const SwitchBase: Constructor<NativeMethods> & typeof SwitchComponent;
+export class Switch extends SwitchBase {}

package/Libraries/Components/Switch/Switch.js

@@ -9,25 +9,25 @@
  * @generate-docs
  */
 
-import Platform from '../../Utilities/Platform';
-import * as React from 'react';
+import type {ColorValue} from '../../StyleSheet/StyleSheet';
+import type {SyntheticEvent} from '../../Types/CoreEventTypes';
+import type {ViewProps} from '../View/ViewPropTypes';
+
 import StyleSheet from '../../StyleSheet/StyleSheet';
+import Platform from '../../Utilities/Platform';
 import useMergeRefs from '../../Utilities/useMergeRefs';
-
 import AndroidSwitchNativeComponent, {
   Commands as AndroidSwitchCommands,
 } from './AndroidSwitchNativeComponent';
 import SwitchNativeComponent, {
   Commands as SwitchCommands,
 } from './SwitchNativeComponent';
-
-import type {ColorValue} from '../../StyleSheet/StyleSheet';
-import type {SyntheticEvent} from '../../Types/CoreEventTypes';
-import type {ViewProps} from '../View/ViewPropTypes';
+import * as React from 'react';
 
 type SwitchChangeEvent = SyntheticEvent<
   $ReadOnly<{|
     value: boolean,
+    target: number,
   |}>,
 >;
 

package/Libraries/Components/Switch/SwitchNativeComponent.js

@@ -8,17 +8,22 @@
  * @format
  */
 
-import type {BubblingEventHandler, WithDefault} from '../../Types/CodegenTypes';
+import type {HostComponent} from '../../Renderer/shims/ReactNativeTypes';
 import type {ColorValue} from '../../StyleSheet/StyleSheet';
+import type {
+  BubblingEventHandler,
+  Int32,
+  WithDefault,
+} from '../../Types/CodegenTypes';
 import type {ViewProps} from '../View/ViewPropTypes';
-import * as React from 'react';
 
+import codegenNativeCommands from '../../Utilities/codegenNativeCommands';
 import codegenNativeComponent from '../../Utilities/codegenNativeComponent';
-import codegenNativeCommands from 'react-native/Libraries/Utilities/codegenNativeCommands';
-import type {HostComponent} from '../../Renderer/shims/ReactNativeTypes';
+import * as React from 'react';
 
 type SwitchChangeEvent = $ReadOnly<{|
   value: boolean,
+  target: Int32,
 |}>;
 
 type NativeProps = $ReadOnly<{|

package/Libraries/Components/TextInput/AndroidTextInputNativeComponent.js

@@ -8,27 +8,28 @@
  * @format
  */
 
-import type {ViewProps} from '../View/ViewPropTypes';
-import type {
-  BubblingEventHandler,
-  DirectEventHandler,
-  Double,
-  Float,
-  Int32,
-  WithDefault,
-} from '../../Types/CodegenTypes';
 import type {
   HostComponent,
   PartialViewConfig,
 } from '../../Renderer/shims/ReactNativeTypes';
 import type {
+  ColorValue,
   TextStyleProp,
   ViewStyleProp,
-  ColorValue,
 } from '../../StyleSheet/StyleSheet';
-import codegenNativeCommands from '../../Utilities/codegenNativeCommands';
+import type {
+  BubblingEventHandler,
+  DirectEventHandler,
+  Double,
+  Float,
+  Int32,
+  WithDefault,
+} from '../../Types/CodegenTypes';
+import type {ViewProps} from '../View/ViewPropTypes';
 import type {TextInputNativeCommands} from './TextInputNativeCommands';
+
 import * as NativeComponentRegistry from '../../NativeComponent/NativeComponentRegistry';
+import codegenNativeCommands from '../../Utilities/codegenNativeCommands';
 
 export type KeyboardType =
   // Cross Platform
@@ -66,6 +67,8 @@ export type ReturnKeyType =
   | 'route'
   | 'yahoo';
 
+export type SubmitBehavior = 'submit' | 'blurAndSubmit' | 'newline';
+
 export type NativeProps = $ReadOnly<{|
   // This allows us to inherit everything from ViewProps except for style (see below)
   // This must be commented for Fabric codegen to work.
@@ -520,9 +523,34 @@ export type NativeProps = $ReadOnly<{|
    * multiline fields. Note that for multiline fields, setting `blurOnSubmit`
    * to `true` means that pressing return will blur the field and trigger the
    * `onSubmitEditing` event instead of inserting a newline into the field.
+   *
+   * @deprecated
+   * Note that `submitBehavior` now takes the place of `blurOnSubmit` and will
+   * override any behavior defined by `blurOnSubmit`.
+   * @see submitBehavior
    */
   blurOnSubmit?: ?boolean,
 
+  /**
+   * When the return key is pressed,
+   *
+   * For single line inputs:
+   *
+   * - `'newline`' defaults to `'blurAndSubmit'`
+   * - `undefined` defaults to `'blurAndSubmit'`
+   *
+   * For multiline inputs:
+   *
+   * - `'newline'` adds a newline
+   * - `undefined` defaults to `'newline'`
+   *
+   * For both single line and multiline inputs:
+   *
+   * - `'submit'` will only send a submit event and not blur the input
+   * - `'blurAndSubmit`' will both blur the input and send a submit event
+   */
+  submitBehavior?: ?SubmitBehavior,
+
   /**
    * Note that not all Text styles are supported, an incomplete list of what is not supported includes:
    *
@@ -657,7 +685,7 @@ export const __INTERNAL_VIEW_CONFIG: PartialViewConfig = {
       process: require('../../StyleSheet/processColor'),
     },
     textDecorationLine: true,
-    blurOnSubmit: true,
+    submitBehavior: true,
     textAlignVertical: true,
     fontStyle: true,
     textShadowOffset: true,