@office-iss/react-native-win32 0.0.0-canary.287 → 0.0.0-canary.289

package/Libraries/Utilities/DevSettings.js

@@ -14,8 +14,22 @@ import NativeEventEmitter from '../EventEmitter/NativeEventEmitter';
 import NativeDevSettings from '../NativeModules/specs/NativeDevSettings';
 import Platform from '../Utilities/Platform';
 
+/**
+ * The DevSettings module exposes methods for customizing settings for developers in development.
+ */
 let DevSettings: {
+  /**
+   * Adds a custom menu item to the developer menu.
+   *
+   * @param title - The title of the menu item. Is internally used as id and should therefore be unique.
+   * @param handler - The callback invoked when pressing the menu item.
+   */
   addMenuItem(title: string, handler: () => mixed): void,
+  /**
+   * Reload the application.
+   *
+   * @param reason
+   */
   reload(reason?: string): void,
   onFastRefresh(): void,
 } = {

package/Libraries/Utilities/Dimensions.js

@@ -19,6 +19,11 @@ import NativeDeviceInfo, {
 } from './NativeDeviceInfo';
 import invariant from 'invariant';
 
+export type {DisplayMetrics, DisplayMetricsAndroid};
+
+/** @deprecated Use DisplayMetrics */
+export type ScaledSize = DisplayMetrics;
+
 const eventEmitter = new EventEmitter<{
   change: [DimensionsPayload],
 }>();

package/Libraries/Utilities/Dimensions.win32.js

@@ -17,6 +17,11 @@ import NativeDeviceInfo, {
 } from './NativeDeviceInfo';
 import invariant from 'invariant';
 
+export type {DisplayMetrics, DisplayMetricsAndroid};
+
+/** @deprecated Use DisplayMetrics */
+export type ScaledSize = DisplayMetrics;
+
 const eventEmitter = new EventEmitter<{
   change: [DimensionsPayload],
 }>();

package/{flow/Position.js → Libraries/Utilities/Platform.js.flow}

@@ -5,12 +5,9 @@
  * LICENSE file in the root directory of this source tree.
  *
  * @flow strict
- * @nolint
  * @format
  */
 
-declare class Position {
-  coords: Coordinates;
-  timestamp: number;
-  mocked: boolean;
-}
+import type {Platform} from './PlatformTypes';
+
+declare export default Platform;

package/Libraries/Utilities/PlatformTypes.js

@@ -8,14 +8,18 @@
  * @format
  */
 
+export type PlatformOSType =
+  | 'ios'
+  | 'android'
+  | 'macos'
+  | 'windows'
+  | 'win32' // [Windows]
+  | 'web'
+  | 'native';
+
 export type PlatformSelectSpec<T> = {
   default?: T,
-  native?: T,
-  ios?: T,
-  android?: T,
-  win32?: T,
-  windows?: T,
-  ...
+  [PlatformOSType]: T,
 };
 
 type IOSPlatform = {
@@ -90,6 +94,66 @@ type AndroidPlatform = {
   select: <T>(spec: PlatformSelectSpec<T>) => T,
 };
 
+type WindowsPlatform = {
+  __constants: null,
+  OS: 'windows',
+  // $FlowFixMe[unsafe-getters-setters]
+  get Version(): number,
+  // $FlowFixMe[unsafe-getters-setters]
+  get constants(): {
+  // [Windows]
+    isTesting: boolean,
+    isDisableAnimations?: boolean,
+    reactNativeVersion: {
+      major: number,
+      minor: number,
+      patch: number,
+      prerelease: ?string,
+    },
+    reactNativeWindowsVersion: {
+      major: number,
+      minor: number,
+      patch: number,
+    },
+    osVersion: number,
+  },
+  // $FlowFixMe[unsafe-getters-setters]
+  get isTesting(): boolean,
+  // $FlowFixMe[unsafe-getters-setters]
+  get isDisableAnimations(): boolean,
+  // $FlowFixMe[unsafe-getters-setters]
+  get isTV(): boolean,
+  select: <T>(spec: PlatformSelectSpec<T>) => T,
+};
+
+type MacOSPlatform = {
+  __constants: null,
+  OS: 'macos',
+  // $FlowFixMe[unsafe-getters-setters]
+  get Version(): string,
+  // $FlowFixMe[unsafe-getters-setters]
+  get constants(): {
+    isTesting: boolean,
+    osVersion: string,
+    reactNativeVersion: {
+      major: number,
+      minor: number,
+      patch: number,
+      prerelease: ?number,
+    },
+    systemName: string,
+  },
+  // $FlowFixMe[unsafe-getters-setters]
+  get isTV(): boolean,
+  // $FlowFixMe[unsafe-getters-setters]
+  get isVision(): boolean,
+  // $FlowFixMe[unsafe-getters-setters]
+  get isTesting(): boolean,
+  // $FlowFixMe[unsafe-getters-setters]
+  get isDisableAnimations(): boolean,
+  select: <T>(spec: PlatformSelectSpec<T>) => T,
+};
+
 type Win32Platform = {
   __constants: null,
   // $FlowFixMe[cannot-resolve-name]
@@ -123,4 +187,30 @@ type Win32Platform = {
   select: <T>(spec: PlatformSelectSpec<T>) => T,
 };
 
-export type Platform = IOSPlatform | AndroidPlatform | Win32Platform;
+type WebPlatform = {
+  OS: 'web',
+  // $FlowFixMe[unsafe-getters-setters]
+  get constants(): {
+    reactNativeVersion: {
+      major: number,
+      minor: number,
+      patch: number,
+      prerelease: ?string,
+    },
+  },
+  // $FlowFixMe[unsafe-getters-setters]
+  get isTV(): boolean,
+  // $FlowFixMe[unsafe-getters-setters]
+  get isTesting(): boolean,
+  // $FlowFixMe[unsafe-getters-setters]
+  get isDisableAnimations(): boolean,
+  select: <T>(spec: PlatformSelectSpec<T>) => T,
+};
+
+export type Platform =
+  | IOSPlatform
+  | AndroidPlatform
+  | WindowsPlatform
+  | Win32Platform // [Windows]
+  | MacOSPlatform
+  | WebPlatform;

package/Libraries/Utilities/codegenNativeCommands.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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
+ */
+
+interface Options<T extends string> {
+  readonly supportedCommands: ReadonlyArray<T>;
+}
+
+declare function codegenNativeCommands<T extends object>(
+  options: Options<keyof T extends string ? keyof T : never>,
+): T;
+
+export default codegenNativeCommands;

package/Libraries/Utilities/codegenNativeComponent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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 {HostComponent} from 'react-native';
+
+interface Options {
+  readonly interfaceOnly?: boolean | undefined;
+  readonly paperComponentName?: string | undefined;
+  readonly paperComponentNameDeprecated?: string | undefined;
+  readonly excludedPlatforms?: ReadonlyArray<'iOS' | 'android'> | undefined;
+}
+
+type NativeComponentType<T> = HostComponent<T>;
+
+declare function codegenNativeComponent<Props extends object>(
+  componentName: string,
+  options?: Options,
+): NativeComponentType<Props>;
+
+export default codegenNativeComponent;

package/Libraries/Utilities/codegenNativeComponent.js

@@ -10,7 +10,7 @@
 
 // TODO: move this file to shims/ReactNative (requires React update and sync)
 
-import type {HostComponent} from '../../Libraries/Renderer/shims/ReactNativeTypes';
+import type {HostComponent} from '../../src/private/types/HostComponent';
 
 import requireNativeComponent from '../../Libraries/ReactNative/requireNativeComponent';
 import UIManager from '../ReactNative/UIManager';

package/Libraries/__flowtests__/ReactNativeTypes-flowtest.js

@@ -8,10 +8,8 @@
  * @format
  */
 
-import type {
-  HostComponent,
-  HostInstance,
-} from '../Renderer/shims/ReactNativeTypes';
+import type {HostComponent} from '../../src/private/types/HostComponent';
+import type {HostInstance} from '../../src/private/types/HostInstance';
 
 import * as React from 'react';
 

package/Libraries/vendor/emitter/EventEmitter.js

@@ -72,8 +72,12 @@ export default class EventEmitter<
   > = $ReadOnly<Record<string, $ReadOnlyArray<UnsafeObject>>>,
 > implements IEventEmitter<TEventToArgsMap>
 {
-  // $FlowFixMe[incompatible-type]
-  #registry: Registry<TEventToArgsMap> = {};
+  #registry: Registry<TEventToArgsMap>;
+
+  constructor() {
+    // $FlowFixMe[incompatible-type]
+    this.#registry = {};
+  }
 
   /**
    * Registers a listener that is called when the supplied event is emitted.

package/flow/global.js

@@ -15,6 +15,7 @@
  * when defining the types here. Consider both presence (`?`) as well as
  * writeability (`+`) when defining types.
  */
+// $FlowFixMe[libdef-override]
 declare var global: {
   // setUpGlobals
   +window: typeof global,

package/flow/jest.js

@@ -1040,10 +1040,12 @@ declare var describe: {
    * @param {table} table of Test
    */
   each(
-    ...table: Array<Array<mixed> | mixed> | [Array<string>, string]
+    ...table:
+      | $ReadOnlyArray<$ReadOnlyArray<mixed> | mixed>
+      | [$ReadOnlyArray<string>, string]
   ): (
     name: JestTestName,
-    fn?: (...args: Array<any>) => ?Promise<mixed>,
+    fn?: (...args: $ReadOnlyArray<any>) => ?Promise<mixed>,
     timeout?: number,
   ) => void,
   ...

package/index.js

@@ -31,14 +31,7 @@ const warnOnce = require('./Libraries/Utilities/warnOnce').default;
 const invariant = require('invariant');
 
 module.exports = {
-  get registerCallableModule() {
-    return require('./Libraries/Core/registerCallableModule').default;
-  },
   // #region Components
-  get AccessibilityInfo() {
-    return require('./Libraries/Components/AccessibilityInfo/AccessibilityInfo')
-      .default;
-  },
   get ActivityIndicator() {
     return require('./Libraries/Components/ActivityIndicator/ActivityIndicator')
       .default;
@@ -63,14 +56,14 @@ module.exports = {
     return require('./Libraries/Components/TextInput/InputAccessoryView')
       .default;
   },
-  get experimental_LayoutConformance() {
-    return require('./Libraries/Components/LayoutConformance/LayoutConformance')
-      .default;
-  },
   get KeyboardAvoidingView() {
     return require('./Libraries/Components/Keyboard/KeyboardAvoidingView')
       .default;
   },
+  get experimental_LayoutConformance() {
+    return require('./Libraries/Components/LayoutConformance/LayoutConformance')
+      .default;
+  },
   get Modal() {
     return require('./Libraries/Modal/Modal').default;
   },
@@ -141,6 +134,10 @@ module.exports = {
   },
   // #endregion
   // #region APIs
+  get AccessibilityInfo() {
+    return require('./Libraries/Components/AccessibilityInfo/AccessibilityInfo')
+      .default;
+  },
   get ActionSheetIOS() {
     return require('./Libraries/ActionSheetIOS/ActionSheetIOS').default;
   },
@@ -156,7 +153,7 @@ module.exports = {
     return require('./Libraries/Utilities/Appearance');
   },
   get AppRegistry() {
-    return require('./Libraries/ReactNative/AppRegistry').default;
+    return require('./Libraries/ReactNative/AppRegistry').AppRegistry;
   },
   get AppState() {
     return require('./Libraries/AppState/AppState').default;
@@ -173,6 +170,15 @@ module.exports = {
     );
     return require('./Libraries/Components/Clipboard/Clipboard').default;
   },
+  get codegenNativeCommands() {
+    return require('./Libraries/Utilities/codegenNativeCommands').default;
+  },
+  get codegenNativeComponent() {
+    return require('./Libraries/Utilities/codegenNativeComponent').default;
+  },
+  get DeviceEventEmitter() {
+    return require('./Libraries/EventEmitter/RCTDeviceEventEmitter').default;
+  },
   get DeviceInfo() {
     return require('./Libraries/Utilities/DeviceInfo').default;
   },
@@ -185,6 +191,10 @@ module.exports = {
   get Dimensions() {
     return require('./Libraries/Utilities/Dimensions').default;
   },
+  get DynamicColorIOS() {
+    return require('./Libraries/StyleSheet/PlatformColorValueTypesIOS')
+      .DynamicColorIOS;
+  },
   get Easing() {
     return require('./Libraries/Animated/Easing').default;
   },
@@ -209,6 +219,9 @@ module.exports = {
   get LogBox() {
     return require('./Libraries/LogBox/LogBox').default;
   },
+  get NativeAppEventEmitter() {
+    return require('./Libraries/EventEmitter/RCTNativeAppEventEmitter').default;
+  },
   get NativeDialogManagerAndroid() {
     return require('./Libraries/NativeModules/specs/NativeDialogManagerAndroid')
       .default;
@@ -216,6 +229,9 @@ module.exports = {
   get NativeEventEmitter() {
     return require('./Libraries/EventEmitter/NativeEventEmitter').default;
   },
+  get NativeModules() {
+    return require('./Libraries/BatchedBridge/NativeModules').default;
+  },
   get Networking() {
     return require('./Libraries/Network/RCTNetworking').default;
   },
@@ -228,6 +244,13 @@ module.exports = {
   get PixelRatio() {
     return require('./Libraries/Utilities/PixelRatio').default;
   },
+  get Platform() {
+    return require('./Libraries/Utilities/Platform').default;
+  },
+  get PlatformColor() {
+    return require('./Libraries/StyleSheet/PlatformColorValueTypes')
+      .PlatformColor;
+  },
   get PushNotificationIOS() {
     warnOnce(
       'pushNotificationIOS-moved',
@@ -238,6 +261,18 @@ module.exports = {
     return require('./Libraries/PushNotificationIOS/PushNotificationIOS')
       .default;
   },
+  get processColor() {
+    return require('./Libraries/StyleSheet/processColor').default;
+  },
+  get registerCallableModule() {
+    return require('./Libraries/Core/registerCallableModule').default;
+  },
+  get requireNativeComponent() {
+    return require('./Libraries/ReactNative/requireNativeComponent').default;
+  },
+  get RootTagContext() {
+    return require('./Libraries/ReactNative/RootTag').RootTagContext;
+  },
   get Settings() {
     return require('./Libraries/Settings/Settings').default;
   },
@@ -279,37 +314,6 @@ module.exports = {
     return require('./Libraries/Vibration/Vibration').default;
   },
   // #endregion
-  // #region Plugins
-  get DeviceEventEmitter() {
-    return require('./Libraries/EventEmitter/RCTDeviceEventEmitter').default;
-  },
-  get DynamicColorIOS() {
-    return require('./Libraries/StyleSheet/PlatformColorValueTypesIOS')
-      .DynamicColorIOS;
-  },
-  get NativeAppEventEmitter() {
-    return require('./Libraries/EventEmitter/RCTNativeAppEventEmitter').default;
-  },
-  get NativeModules() {
-    return require('./Libraries/BatchedBridge/NativeModules').default;
-  },
-  get Platform() {
-    return require('./Libraries/Utilities/Platform').default;
-  },
-  get PlatformColor() {
-    return require('./Libraries/StyleSheet/PlatformColorValueTypes')
-      .PlatformColor;
-  },
-  get processColor() {
-    return require('./Libraries/StyleSheet/processColor').default;
-  },
-  get requireNativeComponent() {
-    return require('./Libraries/ReactNative/requireNativeComponent').default;
-  },
-  get RootTagContext() {
-    return require('./Libraries/ReactNative/RootTag').RootTagContext;
-  },
-  // #endregion
 } as ReactNativePublicAPI;
 
 if (__DEV__) {