not-react-native-macos 0.83.0-rc.1 → 0.87.1-rc.10

package/Libraries/ActionSheetIOS/ActionSheetIOS.js

@@ -16,7 +16,7 @@ import RCTActionSheetManager from './NativeActionSheetManager';
 const processColor = require('../StyleSheet/processColor').default;
 const invariant = require('invariant');
 
-export type ActionSheetIOSOptions = $ReadOnly<{
+export type ActionSheetIOSOptions = Readonly<{
   title?: ?string,
   message?: ?string,
   options: Array<string>,
@@ -30,7 +30,7 @@ export type ActionSheetIOSOptions = $ReadOnly<{
   disabledButtonIndices?: Array<number>,
 }>;
 
-export type ShareActionSheetIOSOptions = $ReadOnly<{
+export type ShareActionSheetIOSOptions = Readonly<{
   message?: ?string,
   url?: ?string,
   subject?: ?string,
@@ -38,11 +38,15 @@ export type ShareActionSheetIOSOptions = $ReadOnly<{
   tintColor?: ?number,
   cancelButtonTintColor?: ?number,
   disabledButtonTintColor?: ?number,
+  /**
+   * The activities to exclude from the ActionSheet.
+   * For example: ['com.apple.UIKit.activity.PostToTwitter']
+   */
   excludedActivityTypes?: ?Array<string>,
   userInterfaceStyle?: ?string,
 }>;
 
-export type ShareActionSheetError = $ReadOnly<{
+export type ShareActionSheetError = Readonly<{
   domain: string,
   code: string,
   userInfo?: ?Object,
@@ -50,9 +54,10 @@ export type ShareActionSheetError = $ReadOnly<{
 }>;
 
 /**
- * Display action sheets and share sheets on iOS.
+ * Displays native iOS action sheets and share sheets.
  *
- * See https://reactnative.dev/docs/actionsheetios
+ * @see https://reactnative.dev/docs/actionsheetios
+ * @platform ios
  */
 const ActionSheetIOS = {
   /**
@@ -62,15 +67,13 @@ const ActionSheetIOS = {
    *
    * - `options` (array of strings) - a list of button titles (required)
    * - `cancelButtonIndex` (int) - index of cancel button in `options`
-   * - `destructiveButtonIndex` (int or array of ints) - index or indices of destructive buttons in `options`
+   * - `destructiveButtonIndex` (int or array of ints) - indices of destructive buttons in `options`
    * - `title` (string) - a title to show above the action sheet
    * - `message` (string) - a message to show below the title
    * - `disabledButtonIndices` (array of numbers) - a list of button indices which should be disabled
    *
-   * The 'callback' function takes one parameter, the zero-based index
-   * of the selected item.
-   *
-   * See https://reactnative.dev/docs/actionsheetios#showactionsheetwithoptions
+   * The `callback` function receives the zero-based index of the selected
+   * item.
    */
   showActionSheetWithOptions(
     options: ActionSheetIOSOptions,
@@ -136,27 +139,19 @@ const ActionSheetIOS = {
   },
 
   /**
-   * Display the iOS share sheet. The `options` object should contain
-   * one or both of `message` and `url` and can additionally have
-   * a `subject` or `excludedActivityTypes`:
+   * Display the iOS share sheet. The `options` object should contain one or
+   * both of `message` and `url` and can additionally have a `subject` or
+   * `excludedActivityTypes`:
    *
    * - `url` (string) - a URL to share
    * - `message` (string) - a message to share
    * - `subject` (string) - a subject for the message
-   * - `excludedActivityTypes` (array) - the activities to exclude from
-   *   the ActionSheet
+   * - `excludedActivityTypes` (array) - the activities to exclude from the ActionSheet
    * - `tintColor` (color) - tint color of the buttons
    *
-   * The 'failureCallback' function takes one parameter, an error object.
-   * The only property defined on this object is an optional `stack` property
-   * of type `string`.
-   *
-   * The 'successCallback' function takes two parameters:
-   *
-   * - a boolean value signifying success or failure
-   * - a string that, in the case of success, indicates the method of sharing
-   *
-   * See https://reactnative.dev/docs/actionsheetios#showshareactionsheetwithoptions
+   * The `failureCallback` function receives an error object. The
+   * `successCallback` function receives a boolean indicating success and a
+   * string describing the sharing method used.
    */
   showShareActionSheetWithOptions(
     options: ShareActionSheetIOSOptions,
@@ -186,8 +181,8 @@ const ActionSheetIOS = {
   },
 
   /**
-   * Dismisses the most upper iOS action sheet presented, if no action sheet is
-   * present a warning is displayed.
+   * Dismiss the most upper action sheet currently presented. Displays a
+   * warning if no action sheet is present.
    */
   dismissActionSheet: () => {
     invariant(RCTActionSheetManager, "ActionSheetManager doesn't exist");

package/Libraries/Alert/Alert.js

@@ -35,14 +35,6 @@ export type AlertButton = {
   ...
 };
 
-// [macOS
-export type DefaultInputsArray = Array<{
-  default?: string,
-  placeholder?: string,
-  style?: AlertButtonStyle,
-}>;
-// macOS]
-
 export type AlertButtons = Array<AlertButton>;
 
 export type AlertOptions = {
@@ -51,10 +43,6 @@ export type AlertOptions = {
   userInterfaceStyle?: 'unspecified' | 'light' | 'dark',
   /** @platform android */
   onDismiss?: ?() => void,
-  // [macOS
-  modal?: ?boolean,
-  critical?: ?boolean,
-  // macOS]
   ...
 };
 
@@ -69,9 +57,43 @@ export type AlertOptions = {
  * alerts. On iOS, you can show an alert that prompts the user to enter
  * some information.
  *
- * See https://reactnative.dev/docs/alert
+ * ## iOS
+ *
+ * On iOS you can specify any number of buttons. Each button can optionally
+ * specify a style, which is one of 'default', 'cancel' or 'destructive'.
+ *
+ * ## Android
+ *
+ * On Android at most three buttons can be specified. Android has a concept
+ * of a neutral, negative and a positive button:
+ *
+ *   - If you specify one button, it will be the 'positive' one (such as 'OK')
+ *   - Two buttons mean 'negative', 'positive' (such as 'Cancel', 'OK')
+ *   - Three buttons mean 'neutral', 'negative', 'positive' (such as 'Later', 'Cancel', 'OK')
+ *
+ * Example:
+ *
+ * ```tsx
+ * // Works on both iOS and Android
+ * Alert.alert(
+ *   'Alert Title',
+ *   'My Alert Msg',
+ *   [
+ *     {text: 'Ask me later', onPress: () => console.log('Ask me later pressed')},
+ *     {text: 'Cancel', onPress: () => console.log('Cancel Pressed'), style: 'cancel'},
+ *     {text: 'OK', onPress: () => console.log('OK Pressed')},
+ *   ]
+ * )
+ * ```
+ *
+ * @see https://reactnative.dev/docs/alert
  */
 class Alert {
+  /**
+   * Display an alert dialog with the specified title, message, and buttons.
+   * On Android, at most three buttons can be specified. On iOS, any number of
+   * buttons can be used.
+   */
   static alert(
     title: ?string,
     message?: ?string,
@@ -88,18 +110,6 @@ class Alert {
         undefined,
         options,
       );
-      // [macOS
-    } else if (Platform.OS === 'macos') {
-      Alert.promptMacOS(
-        title,
-        message,
-        buttons,
-        'default',
-        undefined,
-        options?.modal,
-        options?.critical,
-      );
-      // macOS]
     } else if (Platform.OS === 'android') {
       const NativeDialogManagerAndroid =
         require('../NativeModules/specs/NativeDialogManagerAndroid').default;
@@ -164,6 +174,9 @@ class Alert {
   }
 
   /**
+   * Create and display a prompt to enter text. Accepts a title, message,
+   * callback or buttons, input type, default value, keyboard type, and options.
+   *
    * @platform ios
    */
   static prompt(
@@ -220,103 +233,8 @@ class Alert {
           cb && cb(value);
         },
       );
-      // [macOS
-    } else if (Platform.OS === 'macos') {
-      const defaultInputs: DefaultInputsArray = [{default: defaultValue}];
-      Alert.promptMacOS(title, message, callbackOrButtons, type, defaultInputs);
     }
-    // macOS]
-  }
-
-  // [macOS
-  /**
-   * Create and display a prompt to enter some text.
-   * @static
-   * @method promptMacOS
-   * @param title The dialog's title.
-   * @param message An optional message that appears above the text
-   *    input.
-   * @param callbackOrButtons This optional argument should
-   *    be either a single-argument function or an array of buttons. If passed
-   *    a function, it will be called with the prompt's value when the user
-   *    taps 'OK'.
-   *
-   *    If passed an array of button configurations, each button should include
-   *    a `text` key, as well as optional `onPress` key (see
-   *    example).
-   * @param type This configures the text input. One of 'plain-text',
-   *    'secure-text' or 'login-password'.
-   * @param defaultInputs This optional argument should be an array of couple
-   *    default value - placeholder for the input fields.
-   * @param modal The alert can be optionally run as an app-modal dialog, instead
-   *    of the default presentation as a sheet.
-   * @param critical This optional argument should be used when it's needed to
-   *    warn the user about severe consequences of an impending event
-   *    (such as deleting a file).
-   *
-   * @example <caption>Example with custom buttons</caption>
-   *
-   * AlertMacOS.promptMacOS(
-   *   'Enter password',
-   *   'Enter your password to claim your $1.5B in lottery winnings',
-   *   [
-   *     {text: 'Cancel', onPress: () => console.log('Cancel Pressed'), style: 'cancel'},
-   *     {text: 'OK', onPress: password => console.log('OK Pressed, password: ' + password)},
-   *   ],
-   *   'secure-text'
-   * );
-   *
-   * @example <caption>Example with the default button and a custom callback</caption>
-   *
-   * AlertMacOS.prompt(
-   *   'Update username',
-   *   null,
-   *   text => console.log("Your username is "+text),
-   *   null,
-   *   'default'
-   * );
-   */
-  static promptMacOS(
-    title: ?string,
-    message?: ?string,
-    callbackOrButtons?: ?((text: string) => void) | AlertButtons,
-    type?: ?AlertType = 'plain-text',
-    defaultInputs?: DefaultInputsArray,
-    modal?: ?boolean,
-    critical?: ?boolean,
-  ): void {
-    let callbacks: Array<?any> = [];
-    const buttons = [];
-    if (typeof callbackOrButtons === 'function') {
-      callbacks = [callbackOrButtons];
-    } else if (callbackOrButtons instanceof Array) {
-      callbackOrButtons.forEach((btn, index) => {
-        callbacks[index] = btn.onPress;
-        if (btn.text || index < (callbackOrButtons || []).length - 1) {
-          const btnDef: {[number]: string} = {};
-          btnDef[index] = btn.text || '';
-          buttons.push(btnDef);
-        }
-      });
-    }
-
-    alertWithArgs(
-      {
-        title: title || undefined,
-        message: message || undefined,
-        buttons,
-        type: type || undefined,
-        defaultInputs,
-        modal: modal || undefined,
-        critical: critical || undefined,
-      },
-      (id, value) => {
-        const cb = callbacks[id];
-        cb && cb(value);
-      },
-    );
   }
-  // macOS]
 }
 
 export default Alert;

package/Libraries/Alert/RCTAlertManager.macos.js

@@ -1,16 +1,21 @@
-/**
- * Copyright (c) 2015-present, Facebook, Inc.
+/*
+ * 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
+ * @format
  */
 
-// [macOS]
+// [macOS] macOS resolves as `.macos` -> `.native` -> shared, so without this
+// file `RCTAlertManager` re-exports itself: the shared file is a
+// stub that expects a platform-suffixed sibling to answer. Point it at the iOS
+// implementation, which is what this fork uses on macOS wherever upstream has
+// no platform-neutral one. macOS]
 
-/* $FlowFixMe allow macOS to share iOS file */
-const alertWithArgs = require('./RCTAlertManager.ios');
+// 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".
 
-module.exports = alertWithArgs;
+export * from './RCTAlertManager.ios';

package/Libraries/Animated/Animated.d.ts

@@ -77,6 +77,13 @@ export namespace Animated {
     readonly useNativeDriver: boolean;
   };
 
+  type AnimatedColorInputValue =
+    | RgbaValue
+    | RgbaAnimatedValue
+    | ColorValue
+    | null
+    | undefined;
+
   class AnimatedColor extends AnimatedWithChildren {
     r: AnimatedValue;
     g: AnimatedValue;
@@ -84,7 +91,7 @@ export namespace Animated {
     a: AnimatedValue;
 
     constructor(
-      valueIn?: RgbaValue | RgbaAnimatedValue | ColorValue | null,
+      valueIn?: AnimatedColorInputValue,
       config?: AnimatedConfig | null,
     );
     nativeColor: unknown; // Unsure what to do here

package/Libraries/Animated/AnimatedEvent.js

@@ -25,7 +25,7 @@ export type Mapping =
   | AnimatedValue
   | AnimatedValueXY;
 export type EventConfig<T> = {
-  listener?: ?(NativeSyntheticEvent<T>) => mixed,
+  listener?: ?(NativeSyntheticEvent<T>) => unknown,
   useNativeDriver: boolean,
   platformConfig?: PlatformConfig,
 };
@@ -33,14 +33,14 @@ export type EventConfig<T> = {
 export function attachNativeEventImpl(
   viewRef: any,
   eventName: string,
-  argMapping: $ReadOnlyArray<?Mapping>,
+  argMapping: ReadonlyArray<?Mapping>,
   platformConfig: ?PlatformConfig,
 ): {detach: () => void} {
   // Find animated values in `argMapping` and create an array representing their
   // key path inside the `nativeEvent` object. Ex.: ['contentOffset', 'x'].
   const eventMappings: Array<EventMapping> = [];
 
-  const traverse = (value: mixed, path: Array<string>) => {
+  const traverse = (value: unknown, path: Array<string>) => {
     if (value instanceof AnimatedValue) {
       value.__makeNative(platformConfig);
 
@@ -93,7 +93,7 @@ export function attachNativeEventImpl(
   };
 }
 
-function validateMapping(argMapping: $ReadOnlyArray<?Mapping>, args: any) {
+function validateMapping(argMapping: ReadonlyArray<?Mapping>, args: any) {
   const validate = (recMapping: ?Mapping, recEvt: any, key: string) => {
     if (recMapping instanceof AnimatedValue) {
       invariant(
@@ -146,13 +146,13 @@ function validateMapping(argMapping: $ReadOnlyArray<?Mapping>, args: any) {
 }
 
 export class AnimatedEvent {
-  _argMapping: $ReadOnlyArray<?Mapping>;
+  _argMapping: ReadonlyArray<?Mapping>;
   _listeners: Array<Function> = [];
   _attachedEvent: ?{detach: () => void, ...};
   __isNative: boolean;
   __platformConfig: ?PlatformConfig;
 
-  constructor(argMapping: $ReadOnlyArray<?Mapping>, config: EventConfig<any>) {
+  constructor(argMapping: ReadonlyArray<?Mapping>, config: EventConfig<any>) {
     this._argMapping = argMapping;
 
     if (config == null) {
@@ -199,7 +199,7 @@ export class AnimatedEvent {
     this._attachedEvent && this._attachedEvent.detach();
   }
 
-  __getHandler(): any | ((...args: any) => void) {
+  __getHandler(): (...args: any) => void {
     if (this.__isNative) {
       if (__DEV__) {
         let validatedMapping = false;

package/Libraries/Animated/AnimatedExports.js

@@ -24,21 +24,43 @@ const Animated: typeof AnimatedImplementation = Platform.isDisableAnimations
   : AnimatedImplementation;
 
 export default {
+  /**
+   * FlatList and SectionList infer generic Type defined under their `data` and `section` props.
+   */
   get FlatList(): AnimatedFlatList<any> {
     return require('./components/AnimatedFlatList').default;
   },
+  /**
+   * Animated variants of the basic native views. Accepts Animated.Value for
+   * props and style.
+   */
   get Image(): AnimatedImage {
     return require('./components/AnimatedImage').default;
   },
+  /**
+   * Animated variants of the basic native views. Accepts Animated.Value for
+   * props and style.
+   */
   get ScrollView(): AnimatedScrollView {
     return require('./components/AnimatedScrollView').default;
   },
+  /**
+   * FlatList and SectionList infer generic Type defined under their `data` and `section` props.
+   */
   get SectionList(): AnimatedSectionList<any, any> {
     return require('./components/AnimatedSectionList').default;
   },
+  /**
+   * Animated variants of the basic native views. Accepts Animated.Value for
+   * props and style.
+   */
   get Text(): AnimatedText {
     return require('./components/AnimatedText').default;
   },
+  /**
+   * Animated variants of the basic native views. Accepts Animated.Value for
+   * props and style.
+   */
   get View(): AnimatedView {
     return require('./components/AnimatedView').default;
   },

package/Libraries/Animated/AnimatedExports.js.flow

@@ -10,7 +10,7 @@
 
 import AnimatedImplementation from './AnimatedImplementation';
 
-export type {CompositeAnimation} from './AnimatedImplementation';
+export type {CompositeAnimation, Numeric} from './AnimatedImplementation';
 export type {DecayAnimationConfig} from './animations/DecayAnimation';
 export type {SpringAnimationConfig} from './animations/SpringAnimation';
 export type {TimingAnimationConfig} from './animations/TimingAnimation';