@office-iss/react-native-win32 0.73.1 → 0.74.0-preview.1

package/Libraries/PushNotificationIOS/NativePushNotificationManagerIOS.js

@@ -4,76 +4,10 @@
  * 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
- * @flow
  */
 
-import type {TurboModule} from '../TurboModule/RCTExport';
-
-import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
-
-type Permissions = {|
-  alert: boolean,
-  badge: boolean,
-  sound: boolean,
-|};
-
-type Notification = {|
-  +alertTitle?: ?string,
-  // Actual type: string | number
-  +fireDate?: ?number,
-  +alertBody?: ?string,
-  +alertAction?: ?string,
-  +userInfo?: ?Object,
-  +category?: ?string,
-  // Actual type: 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute'
-  +repeatInterval?: ?string,
-  +applicationIconBadgeNumber?: ?number,
-  +isSilent?: ?boolean,
-  +soundName?: ?string,
-|};
-
-export interface Spec extends TurboModule {
-  +getConstants: () => {||};
-  +onFinishRemoteNotification: (
-    notificationId: string,
-    /**
-     * Type:
-     *  'UIBackgroundFetchResultNewData' |
-     *  'UIBackgroundFetchResultNoData' |
-     *  'UIBackgroundFetchResultFailed'
-     */
-    fetchResult: string,
-  ) => void;
-  +setApplicationIconBadgeNumber: (num: number) => void;
-  +getApplicationIconBadgeNumber: (callback: (num: number) => void) => void;
-  +requestPermissions: (permission: {|
-    +alert: boolean,
-    +badge: boolean,
-    +sound: boolean,
-  |}) => Promise<Permissions>;
-  +abandonPermissions: () => void;
-  +checkPermissions: (callback: (permissions: Permissions) => void) => void;
-  +presentLocalNotification: (notification: Notification) => void;
-  +scheduleLocalNotification: (notification: Notification) => void;
-  +cancelAllLocalNotifications: () => void;
-  +cancelLocalNotifications: (userInfo: Object) => void;
-  +getInitialNotification: () => Promise<?Notification>;
-  +getScheduledLocalNotifications: (
-    callback: (notification: Notification) => void,
-  ) => void;
-  +removeAllDeliveredNotifications: () => void;
-  +removeDeliveredNotifications: (identifiers: Array<string>) => void;
-  +getDeliveredNotifications: (
-    callback: (notification: Array<Notification>) => void,
-  ) => void;
-  +getAuthorizationStatus: (
-    callback: (authorizationStatus: number) => void,
-  ) => void;
-  +addListener: (eventType: string) => void;
-  +removeListeners: (count: number) => void;
-}
-
-export default (TurboModuleRegistry.get<Spec>(
-  'PushNotificationManager',
-): ?Spec);
+export * from '../../src/private/specs/modules/NativePushNotificationManagerIOS';
+import NativePushNotificationManagerIOS from '../../src/private/specs/modules/NativePushNotificationManagerIOS';
+export default NativePushNotificationManagerIOS;

package/Libraries/PushNotificationIOS/PushNotificationIOS.js

@@ -68,12 +68,16 @@ export type FetchResult = {
 export type PushNotificationEventName = $Keys<{
   /**
    * Fired when a remote notification is received. The handler will be invoked
-   * with an instance of `PushNotificationIOS`.
+   * with an instance of `PushNotificationIOS`. This will handle notifications
+   * that arrive in the foreground or were tapped to open the app from the
+   * background.
    */
   notification: string,
   /**
    * Fired when a local notification is received. The handler will be invoked
-   * with an instance of `PushNotificationIOS`.
+   * with an instance of `PushNotificationIOS`. This will handle notifications
+   * that arrive in the foreground or were tapped to open the app from the
+   * background.
    */
   localNotification: string,
   /**
@@ -83,8 +87,8 @@ export type PushNotificationEventName = $Keys<{
   register: string,
   /**
    * Fired when the user fails to register for remote notifications. Typically
-   * occurs when APNS is having issues, or the device is a simulator. The
-   * handler will be invoked with {message: string, code: number, details: any}.
+   * occurs due to APNS issues or if the device is a simulator. The handler
+   * will be invoked with {message: string, code: number, details: any}.
    */
   registrationError: string,
   ...
@@ -92,8 +96,7 @@ export type PushNotificationEventName = $Keys<{
 
 /**
  *
- * Handle push notifications for your app, including permission handling and
- * icon badge number.
+ * Handle notifications for your app, including scheduling and permissions.
  *
  * See https://reactnative.dev/docs/pushnotificationios
  */
@@ -116,7 +119,7 @@ class PushNotificationIOS {
   };
 
   /**
-   * Schedules the localNotification for immediate presentation.
+   * Schedules a local notification for immediate presentation.
    *
    * See https://reactnative.dev/docs/pushnotificationios#presentlocalnotification
    */
@@ -129,7 +132,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Schedules the localNotification for future presentation.
+   * Schedules a local notification for future presentation.
    *
    * See https://reactnative.dev/docs/pushnotificationios#schedulelocalnotification
    */
@@ -142,7 +145,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Cancels all scheduled localNotifications.
+   * Cancels all scheduled local notifications.
    *
    * See https://reactnative.dev/docs/pushnotificationios#cancelalllocalnotifications
    */
@@ -155,7 +158,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Remove all delivered notifications from Notification Center.
+   * Removes all delivered notifications from Notification Center.
    *
    * See https://reactnative.dev/docs/pushnotificationios#removealldeliverednotifications
    */
@@ -168,7 +171,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * Provides you with a list of the app’s notifications that are still displayed in Notification Center.
+   * Provides a list of the app’s notifications that are currently displayed
+   * in Notification Center.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getdeliverednotifications
    */
@@ -183,7 +187,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Removes the specified notifications from Notification Center
+   * Removes the specified notifications from Notification Center.
    *
    * See https://reactnative.dev/docs/pushnotificationios#removedeliverednotifications
    */
@@ -196,7 +200,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Sets the badge number for the app icon on the home screen.
+   * Sets the badge number for the app icon on the Home Screen.
    *
    * See https://reactnative.dev/docs/pushnotificationios#setapplicationiconbadgenumber
    */
@@ -209,7 +213,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the current badge number for the app icon on the home screen.
+   * Gets the current badge number for the app icon on the Home Screen.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getapplicationiconbadgenumber
    */
@@ -222,7 +226,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * Cancel local notifications.
+   * Cancels any scheduled local notifications which match the fields in the
+   * provided `userInfo`.
    *
    * See https://reactnative.dev/docs/pushnotificationios#cancellocalnotification
    */
@@ -235,7 +240,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the local notifications that are currently scheduled.
+   * Gets the list of local notifications that are currently scheduled.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getscheduledlocalnotifications
    */
@@ -248,8 +253,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * Attaches a listener to remote or local notification events while the app
-   * is running in the foreground or the background.
+   * Attaches a listener to notification events including local notifications,
+   * remote notifications, and notification registration results.
    *
    * See https://reactnative.dev/docs/pushnotificationios#addeventlistener
    */
@@ -303,10 +308,7 @@ class PushNotificationIOS {
    *
    * See https://reactnative.dev/docs/pushnotificationios#removeeventlistener
    */
-  static removeEventListener(
-    type: PushNotificationEventName,
-    handler: Function,
-  ): void {
+  static removeEventListener(type: PushNotificationEventName): void {
     invariant(
       type === 'notification' ||
         type === 'register' ||
@@ -323,10 +325,9 @@ class PushNotificationIOS {
   }
 
   /**
-   * Requests notification permissions from iOS, prompting the user's
+   * Requests notification permissions from iOS, prompting the user with a
    * dialog box. By default, it will request all notification permissions, but
-   * a subset of these can be requested by passing a map of requested
-   * permissions.
+   * you can optionally specify which permissions to request.
    *
    * See https://reactnative.dev/docs/pushnotificationios#requestpermissions
    */
@@ -363,7 +364,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * Unregister for all remote notifications received via Apple Push Notification service.
+   * Unregister for all remote notifications received via Apple Push Notification
+   * service. This should be called in rare circumstances only.
    *
    * See https://reactnative.dev/docs/pushnotificationios#abandonpermissions
    */
@@ -376,8 +378,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * See what push permissions are currently enabled. `callback` will be
-   * invoked with a `permissions` object.
+   * Check which push permissions are currently enabled. `callback` will be
+   * invoked with a `Permissions` object.
    *
    * See https://reactnative.dev/docs/pushnotificationios#checkpermissions
    */
@@ -409,7 +411,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * This method returns a promise that resolves to notification authorization status.
+   * This method returns a promise that resolves to the current notification
+   * authorization status. See UNAuthorizationStatus for possible values.
    */
   static getAuthorizationStatus(
     callback: (authorizationStatus: number) => void,
@@ -425,7 +428,7 @@ class PushNotificationIOS {
   /**
    * You will never need to instantiate `PushNotificationIOS` yourself.
    * Listening to the `notification` event and invoking
-   * `getInitialNotification` is sufficient
+   * `getInitialNotification` is sufficient.
    *
    */
   constructor(nativeNotif: Object) {
@@ -464,7 +467,8 @@ class PushNotificationIOS {
 
   /**
    * This method is available for remote notifications that have been received via:
-   * `application:didReceiveRemoteNotification:fetchCompletionHandler:`
+   * `application:didReceiveRemoteNotification:fetchCompletionHandler:`. See docs
+   * for more information.
    *
    * See https://reactnative.dev/docs/pushnotificationios#finish
    */
@@ -489,7 +493,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * An alias for `getAlert` to get the notification's main message string
+   * An alias for `getAlert` to get the notification's main message string.
    */
   getMessage(): ?string | ?Object {
     // alias because "alert" is an ambiguous name
@@ -497,7 +501,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the sound string from the `aps` object
+   * Gets the sound string from the `aps` object. This will be `null` for local
+   * notifications.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getsound
    */
@@ -506,7 +511,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the category string from the `aps` object
+   * Gets the category string from the `aps` object.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getcategory
    */
@@ -515,7 +520,8 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the notification's main message from the `aps` object
+   * Gets the notification's main message from the `aps` object. Also see the
+   * alias: `getMessage()`.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getalert
    */
@@ -524,7 +530,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the content-available number from the `aps` object
+   * Gets the content-available number from the `aps` object.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getcontentavailable
    */
@@ -533,7 +539,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the badge count number from the `aps` object
+   * Gets the badge count number from the `aps` object.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getbadgecount
    */
@@ -542,7 +548,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the data object on the notif
+   * Gets the data object on the notification.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getdata
    */
@@ -551,7 +557,7 @@ class PushNotificationIOS {
   }
 
   /**
-   * Gets the thread ID on the notif
+   * Gets the thread ID on the notification.
    *
    * See https://reactnative.dev/docs/pushnotificationios#getthreadid
    */

package/Libraries/ReactNative/AppContainer-dev.js

@@ -0,0 +1,192 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {
+  ReactDevToolsAgent,
+  ReactDevToolsGlobalHook,
+} from '../Types/ReactDevToolsTypes';
+import type {Props} from './AppContainer';
+
+import ReactNativeStyleAttributes from '../Components/View/ReactNativeStyleAttributes';
+import View from '../Components/View/View';
+import DebuggingOverlay from '../Debugging/DebuggingOverlay';
+import useSubscribeToDebuggingOverlayRegistry from '../Debugging/useSubscribeToDebuggingOverlayRegistry';
+import RCTDeviceEventEmitter from '../EventEmitter/RCTDeviceEventEmitter';
+import ReactDevToolsOverlay from '../Inspector/ReactDevToolsOverlay';
+import LogBoxNotificationContainer from '../LogBox/LogBoxNotificationContainer';
+import StyleSheet from '../StyleSheet/StyleSheet';
+import {RootTagContext, createRootTag} from './RootTag';
+import * as React from 'react';
+
+const {useEffect, useState, useCallback} = React;
+
+const reactDevToolsHook: ReactDevToolsGlobalHook =
+  window.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+
+// Required for React DevTools to view / edit React Native styles in Flipper.
+// Flipper doesn't inject these values when initializing DevTools.
+if (reactDevToolsHook) {
+  reactDevToolsHook.resolveRNStyle = require('../StyleSheet/flattenStyle');
+  reactDevToolsHook.nativeStyleEditorValidAttributes = Object.keys(
+    ReactNativeStyleAttributes,
+  );
+}
+
+type InspectorDeferredProps = {
+  inspectedViewRef: InspectedViewRef,
+  onInspectedViewRerenderRequest: () => void,
+  reactDevToolsAgent?: ReactDevToolsAgent,
+};
+
+const InspectorDeferred = ({
+  inspectedViewRef,
+  onInspectedViewRerenderRequest,
+  reactDevToolsAgent,
+}: InspectorDeferredProps) => {
+  // D39382967 adds a require cycle: InitializeCore -> AppContainer -> Inspector -> InspectorPanel -> ScrollView -> InitializeCore
+  // We can't remove it yet, fallback to dynamic require for now. This is the only reason why this logic is in a separate function.
+  const Inspector = require('../Inspector/Inspector');
+
+  return (
+    <Inspector
+      inspectedViewRef={inspectedViewRef}
+      onRequestRerenderApp={onInspectedViewRerenderRequest}
+      reactDevToolsAgent={reactDevToolsAgent}
+    />
+  );
+};
+
+const AppContainer = ({
+  children,
+  fabric,
+  initialProps,
+  internal_excludeInspector = false,
+  internal_excludeLogBox = false,
+  rootTag,
+  showArchitectureIndicator,
+  WrapperComponent,
+}: Props): React.Node => {
+  const appContainerRootViewRef: AppContainerRootViewRef = React.useRef(null);
+  const innerViewRef: InspectedViewRef = React.useRef(null);
+  const debuggingOverlayRef: DebuggingOverlayRef = React.useRef(null);
+
+  useSubscribeToDebuggingOverlayRegistry(
+    appContainerRootViewRef,
+    debuggingOverlayRef,
+  );
+
+  const [key, setKey] = useState(0);
+  const [shouldRenderInspector, setShouldRenderInspector] = useState(false);
+  const [reactDevToolsAgent, setReactDevToolsAgent] =
+    useState<ReactDevToolsAgent | void>(reactDevToolsHook?.reactDevtoolsAgent);
+
+  useEffect(() => {
+    let inspectorSubscription = null;
+    if (!internal_excludeInspector) {
+      inspectorSubscription = RCTDeviceEventEmitter.addListener(
+        'toggleElementInspector',
+        () => setShouldRenderInspector(value => !value),
+      );
+    }
+
+    let reactDevToolsAgentListener = null;
+    // If this is first render, subscribe to the event from React DevTools hook
+    if (reactDevToolsHook != null && reactDevToolsAgent == null) {
+      reactDevToolsAgentListener = setReactDevToolsAgent;
+      reactDevToolsHook.on?.('react-devtools', reactDevToolsAgentListener);
+    }
+
+    return () => {
+      inspectorSubscription?.remove();
+
+      if (
+        reactDevToolsHook?.off != null &&
+        reactDevToolsAgentListener != null
+      ) {
+        reactDevToolsHook.off('react-devtools', reactDevToolsAgentListener);
+      }
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  let innerView: React.Node = (
+    <View
+      collapsable={reactDevToolsAgent == null && !shouldRenderInspector}
+      pointerEvents="box-none"
+      key={key}
+      style={styles.container}
+      ref={innerViewRef}>
+      {children}
+    </View>
+  );
+
+  if (WrapperComponent != null) {
+    innerView = (
+      <WrapperComponent
+        initialProps={initialProps}
+        fabric={fabric === true}
+        showArchitectureIndicator={showArchitectureIndicator === true}>
+        {innerView}
+      </WrapperComponent>
+    );
+  }
+
+  const onInspectedViewRerenderRequest = useCallback(
+    () => setKey(k => k + 1),
+    [],
+  );
+
+  return (
+    <RootTagContext.Provider value={createRootTag(rootTag)}>
+      <View
+        ref={appContainerRootViewRef}
+        style={styles.container}
+        pointerEvents="box-none">
+        {innerView}
+
+        <DebuggingOverlay ref={debuggingOverlayRef} />
+
+        {reactDevToolsAgent != null && (
+          <ReactDevToolsOverlay
+            inspectedViewRef={innerViewRef}
+            reactDevToolsAgent={reactDevToolsAgent}
+          />
+        )}
+
+        {shouldRenderInspector && (
+          <InspectorDeferred
+            inspectedViewRef={innerViewRef}
+            onInspectedViewRerenderRequest={onInspectedViewRerenderRequest}
+            reactDevToolsAgent={reactDevToolsAgent}
+          />
+        )}
+
+        {!internal_excludeLogBox && <LogBoxNotificationContainer />}
+      </View>
+    </RootTagContext.Provider>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {flex: 1},
+});
+
+export type AppContainerRootViewRef = React.RefObject<React.ElementRef<
+  typeof View,
+> | null>;
+export type InspectedViewRef = React.RefObject<React.ElementRef<
+  typeof View,
+> | null>;
+export type DebuggingOverlayRef = React.RefObject<React.ElementRef<
+  typeof DebuggingOverlay,
+> | null>;
+
+export default AppContainer;

package/Libraries/ReactNative/AppContainer-prod.js

@@ -0,0 +1,53 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {Props} from './AppContainer';
+
+import View from '../Components/View/View';
+import StyleSheet from '../StyleSheet/StyleSheet';
+import {RootTagContext, createRootTag} from './RootTag';
+import * as React from 'react';
+
+const AppContainer = ({
+  children,
+  fabric,
+  initialProps,
+  rootTag,
+  showArchitectureIndicator,
+  WrapperComponent,
+}: Props): React.Node => {
+  let innerView = children;
+
+  if (WrapperComponent != null) {
+    innerView = (
+      <WrapperComponent
+        initialProps={initialProps}
+        fabric={fabric === true}
+        showArchitectureIndicator={showArchitectureIndicator === true}>
+        {innerView}
+      </WrapperComponent>
+    );
+  }
+
+  return (
+    <RootTagContext.Provider value={createRootTag(rootTag)}>
+      <View style={styles.root} pointerEvents="box-none">
+        {innerView}
+      </View>
+    </RootTagContext.Provider>
+  );
+};
+
+const styles = StyleSheet.create({
+  root: {flex: 1},
+});
+
+export default AppContainer;