@office-iss/react-native-win32 0.0.0-canary.297 → 0.0.0-canary.298

package/jest/mock.js

@@ -0,0 +1,39 @@
+/**
+ * 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
+ * @format
+ * @oncall react_native
+ */
+
+/**
+ * Mocks the module referenced by `moduleRef` (expected to begin with `m#`)
+ * while enforcing type safety of mock factories.
+ *
+ * If `factoryRef` is provided, it is expected to reference a module that
+ * exports the same type signature as the module referenced by `moduleRef`.
+ */
+export default function mock<TModuleRef: $Flow$ModuleRef<mixed>>(
+  moduleRef: TModuleRef,
+  factoryRef?: NoInfer<TModuleRef>,
+): void {
+  // NOTE: Jest's `babel-plugin-jest-hoist` requires that the second argument to
+  // `jest.mock` be an inline function, so structure this code accordingly.
+  if (factoryRef === undefined) {
+    jest.mock(deref(moduleRef));
+  } else {
+    // NOTE: Jest's `babel-plugin-jest-hoist` requires that module factories
+    // only reference local variables or variables starting with "mock", so be
+    // careful when renaming this `mockFactory` variable.
+    const mockFactory = deref(factoryRef);
+    jest.mock(deref(moduleRef), () => jest.requireActual(mockFactory));
+  }
+}
+
+function deref(ref: $Flow$ModuleRef<mixed>): string {
+  // $FlowIgnore[incompatible-cast]
+  return (ref as string).substring(2);
+}

package/jest/mockComponent.js

@@ -4,37 +4,62 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
+ * @flow strict
  * @format
  */
 
-'use strict';
+import * as React from 'react';
+import {createElement} from 'react';
 
-module.exports = (moduleName, instanceMethods, isESModule) => {
-  const RealComponent = isESModule
-    ? jest.requireActual(moduleName).default
-    : jest.requireActual(moduleName);
-  const React = require('react');
+type Modulish<T> = T | $ReadOnly<{default: T}>;
+type ModuleDefault<T> = T['default'];
 
-  const SuperClass =
+type TComponentType = React.ComponentType<{...}>;
+
+/**
+ * WARNING: The `moduleName` must be relative to this file's directory, which is
+ * a major footgun. Be careful when using this function!
+ */
+export default function mockComponent<
+  TComponentModule: Modulish<TComponentType>,
+>(
+  moduleName: string,
+  instanceMethods: ?interface {},
+  isESModule: boolean,
+): typeof isESModule extends true
+  ? ModuleDefault<TComponentModule & typeof instanceMethods>
+  : TComponentModule & typeof instanceMethods {
+  const RealComponent: TComponentType = isESModule
+    ? // $FlowIgnore[prop-missing]
+      jest.requireActual<TComponentModule>(moduleName).default
+    : // $FlowIgnore[incompatible-type]
+      jest.requireActual<TComponentModule>(moduleName);
+
+  const SuperClass: typeof React.Component<
+    React.ElementProps<typeof RealComponent>,
+  > =
     typeof RealComponent === 'function' &&
     RealComponent.prototype.constructor instanceof React.Component
       ? RealComponent
       : React.Component;
 
   const name =
-    RealComponent.displayName ||
-    RealComponent.name ||
-    (RealComponent.render // handle React.forwardRef
-      ? RealComponent.render.displayName || RealComponent.render.name
-      : 'Unknown');
+    RealComponent.displayName ??
+    RealComponent.name ??
+    // $FlowFixMe[prop-missing] - Checking for `forwardRef` values.
+    (RealComponent.render == null
+      ? 'Unknown'
+      : // $FlowFixMe[incompatible-use]
+        RealComponent.render.displayName ?? RealComponent.render.name);
 
   const nameWithoutPrefix = name.replace(/^(RCT|RK)/, '');
 
   const Component = class extends SuperClass {
-    static displayName = 'Component';
+    static displayName: ?string = 'Component';
 
-    render() {
-      const props = Object.assign({}, RealComponent.defaultProps);
+    render(): React.Node {
+      // $FlowIgnore[prop-missing]
+      const props = {...RealComponent.defaultProps};
 
       if (this.props) {
         Object.keys(this.props).forEach(prop => {
@@ -49,7 +74,9 @@ module.exports = (moduleName, instanceMethods, isESModule) => {
         });
       }
 
-      return React.createElement(nameWithoutPrefix, props, this.props.children);
+      // $FlowIgnore[not-a-function]
+      // $FlowIgnore[prop-missing]
+      return createElement(nameWithoutPrefix, props, this.props.children);
     }
   };
 
@@ -62,13 +89,16 @@ module.exports = (moduleName, instanceMethods, isESModule) => {
 
   Component.displayName = nameWithoutPrefix;
 
+  // $FlowIgnore[not-an-object]
   Object.keys(RealComponent).forEach(classStatic => {
     Component[classStatic] = RealComponent[classStatic];
   });
 
   if (instanceMethods != null) {
+    // $FlowIgnore[unsafe-object-assign]
     Object.assign(Component.prototype, instanceMethods);
   }
 
+  // $FlowIgnore[incompatible-return]
   return Component;
-};
+}

package/jest/mockNativeComponent.js

@@ -4,31 +4,41 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
+ * @flow strict
  * @format
  */
 
-'use strict';
+import type {HostInstance} from '../src/private/types/HostInstance';
 
-const React = require('react');
-const {createElement} = require('react');
+import * as React from 'react';
+import {createElement} from 'react';
 
 let nativeTag = 1;
 
-export default viewName => {
-  const Component = class extends React.Component {
-    _nativeTag = nativeTag++;
+type MockNativeComponent<TProps: {...}> = component(
+  ref?: ?React.RefSetter<HostInstance>,
+  ...props: TProps
+);
 
-    render() {
+export default function mockNativeComponent<TProps: {...}>(
+  viewName: string,
+): MockNativeComponent<TProps> {
+  const Component = class extends React.Component<TProps> {
+    _nativeTag: number = nativeTag++;
+
+    render(): React.Node {
+      // $FlowIgnore[not-a-function]
+      // $FlowIgnore[prop-missing]
       return createElement(viewName, this.props, this.props.children);
     }
 
     // The methods that exist on host components
-    blur = jest.fn();
-    focus = jest.fn();
-    measure = jest.fn();
-    measureInWindow = jest.fn();
-    measureLayout = jest.fn();
-    setNativeProps = jest.fn();
+    blur: () => void = jest.fn();
+    focus: () => void = jest.fn();
+    measure: () => void = jest.fn();
+    measureInWindow: () => void = jest.fn();
+    measureLayout: () => void = jest.fn();
+    setNativeProps: () => void = jest.fn();
   };
 
   if (viewName === 'RCTView') {
@@ -38,4 +48,4 @@ export default viewName => {
   }
 
   return Component;
-};
+}

package/jest/mocks/AccessibilityInfo.js

@@ -0,0 +1,62 @@
+/**
+ * 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
+ * @format
+ */
+
+const AccessibilityInfo = {
+  addEventListener: jest.fn(() => ({
+    remove: jest.fn(),
+  })) as JestMockFn<$FlowFixMe, {remove: JestMockFn<[], void>}>,
+  announceForAccessibility: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  announceForAccessibilityWithOptions: jest.fn() as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  isAccessibilityServiceEnabled: jest.fn(() =>
+    Promise.resolve(false),
+  ) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  isBoldTextEnabled: jest.fn(() => Promise.resolve(false)) as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  isGrayscaleEnabled: jest.fn(() => Promise.resolve(false)) as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  isInvertColorsEnabled: jest.fn(() => Promise.resolve(false)) as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  isReduceMotionEnabled: jest.fn(() => Promise.resolve(false)) as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  isHighTextContrastEnabled: jest.fn(() =>
+    Promise.resolve(false),
+  ) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  isDarkerSystemColorsEnabled: jest.fn(() =>
+    Promise.resolve(false),
+  ) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  prefersCrossFadeTransitions: jest.fn(() =>
+    Promise.resolve(false),
+  ) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  isReduceTransparencyEnabled: jest.fn(() =>
+    Promise.resolve(false),
+  ) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  isScreenReaderEnabled: jest.fn(() => Promise.resolve(false)) as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  setAccessibilityFocus: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  sendAccessibilityEvent: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  getRecommendedTimeoutMillis: jest.fn(() =>
+    Promise.resolve(false),
+  ) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+};
+
+export default AccessibilityInfo;

package/jest/mocks/ActivityIndicator.js

@@ -0,0 +1,23 @@
+/**
+ * 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
+ */
+
+import typeof TActivityIndicator from '../../Libraries/Components/ActivityIndicator/ActivityIndicator';
+import typeof * as TmockComponent from '../mockComponent';
+
+const mockComponent =
+  jest.requireActual<TmockComponent>('../mockComponent').default;
+
+const ActivityIndicator = mockComponent(
+  '../Libraries/Components/ActivityIndicator/ActivityIndicator',
+  null, // instanceMethods
+  true, // isESModule
+) as TActivityIndicator;
+
+export default ActivityIndicator;

package/jest/mocks/AppState.js

@@ -0,0 +1,19 @@
+/**
+ * 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
+ * @format
+ */
+
+const AppState = {
+  addEventListener: jest.fn(() => ({
+    remove: jest.fn(),
+  })) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  removeEventListener: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  currentState: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+};
+
+export default AppState;

package/{flow/Stringish.js → jest/mocks/Clipboard.js}

@@ -8,7 +8,9 @@
  * @format
  */
 
-// This type allows Facebook to internally Override
-// this type to allow our internationalization type which
-// is a string at runtime but Flow doesn't know that.
-declare type Stringish = string;
+const Clipboard = {
+  getString: jest.fn(async () => '') as JestMockFn<[], Promise<string>>,
+  setString: jest.fn() as JestMockFn<[string], void>,
+};
+
+export default Clipboard;

package/jest/mocks/Image.js

@@ -0,0 +1,23 @@
+/**
+ * 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
+ */
+
+import typeof TImage from '../../Libraries/Image/Image';
+import typeof * as TmockComponent from '../mockComponent';
+
+const mockComponent =
+  jest.requireActual<TmockComponent>('../mockComponent').default;
+
+const Image = mockComponent(
+  '../Libraries/Image/Image',
+  null, // instanceMethods
+  true, // isESModule
+) as TImage;
+
+export default Image;

package/jest/mocks/InitializeCore.js

@@ -0,0 +1,9 @@
+/**
+ * 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
+ * @format
+ */

package/jest/mocks/Linking.js

@@ -0,0 +1,28 @@
+/**
+ * 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
+ * @format
+ */
+
+const Linking = {
+  openURL: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  canOpenURL: jest.fn(() => Promise.resolve(true)) as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  openSettings: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  addEventListener: jest.fn(() => ({
+    remove: jest.fn(),
+  })) as JestMockFn<$FlowFixMe, $FlowFixMe>,
+  getInitialURL: jest.fn(() => Promise.resolve()) as JestMockFn<
+    $FlowFixMe,
+    $FlowFixMe,
+  >,
+  sendIntent: jest.fn() as JestMockFn<$FlowFixMe, $FlowFixMe>,
+};
+
+export default Linking;

package/jest/mocks/Modal.js

@@ -0,0 +1,33 @@
+/**
+ * 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
+ */
+
+import type {ModalProps} from '../../Libraries/Modal/Modal';
+import typeof * as TmockComponent from '../mockComponent';
+
+const mockComponent =
+  jest.requireActual<TmockComponent>('../mockComponent').default;
+
+type TModal = component(...ModalProps);
+
+const BaseComponent = mockComponent(
+  '../Libraries/Modal/Modal',
+  null, // instanceMethods
+  true, // isESModule
+) as TModal;
+
+// $FlowIgnore[incompatible-use]
+export default class Modal extends BaseComponent {
+  render(): React.Node {
+    if (this.props.visible === false) {
+      return null;
+    }
+    return <BaseComponent {...this.props}>{this.props.children}</BaseComponent>;
+  }
+}

package/jest/mocks/NativeComponentRegistry.js

@@ -0,0 +1,30 @@
+/**
+ * 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
+ * @format
+ */
+
+import typeof * as TmockNativeComponent from '../mockNativeComponent';
+
+const mockNativeComponent = jest.requireActual<TmockNativeComponent>(
+  '../mockNativeComponent',
+).default;
+
+export const get = jest.fn((name, viewConfigProvider) => {
+  return mockNativeComponent(name);
+}) as JestMockFn<$FlowFixMe, $FlowFixMe>;
+
+export const getWithFallback_DEPRECATED = jest.fn(
+  (name, viewConfigProvider) => {
+    return mockNativeComponent(name);
+  },
+) as JestMockFn<$FlowFixMe, $FlowFixMe>;
+
+export const setRuntimeConfigProvider = jest.fn() as JestMockFn<
+  $FlowFixMe,
+  $FlowFixMe,
+>;