react-native-windows 0.68.1 → 0.69.0-preview.1

package/Libraries/Components/Touchable/TouchableNativeFeedback.js

@@ -271,6 +271,7 @@ class TouchableNativeFeedback extends React.Component<Props, State> {
         ),
         accessible: this.props.accessible !== false,
         accessibilityHint: this.props.accessibilityHint,
+        accessibilityLanguage: this.props.accessibilityLanguage,
         accessibilityLabel: this.props.accessibilityLabel,
         accessibilityRole: this.props.accessibilityRole,
         accessibilityState: accessibilityState,

package/Libraries/Components/Touchable/TouchableOpacity.js

@@ -225,6 +225,7 @@ class TouchableOpacity extends React.Component<Props, State> {
         accessible={this.props.accessible !== false}
         accessibilityLabel={this.props.accessibilityLabel}
         accessibilityHint={this.props.accessibilityHint}
+        accessibilityLanguage={this.props.accessibilityLanguage}
         accessibilityRole={this.props.accessibilityRole}
         accessibilityState={accessibilityState}
         accessibilityActions={this.props.accessibilityActions}
@@ -260,7 +261,12 @@ class TouchableOpacity extends React.Component<Props, State> {
 
   componentDidUpdate(prevProps: Props, prevState: State) {
     this.state.pressability.configure(this._createPressabilityConfig());
-    if (this.props.disabled !== prevProps.disabled) {
+    if (
+      this.props.disabled !== prevProps.disabled ||
+      (flattenStyle(prevProps.style)?.opacity !==
+        flattenStyle(this.props.style)?.opacity) !==
+        undefined
+    ) {
       this._opacityInactive(250);
     }
   }

package/Libraries/Components/Touchable/TouchableOpacity.windows.js

@@ -146,7 +146,7 @@ class TouchableOpacity extends React.Component<Props, State> {
       pressRectOffset: this.props.pressRetentionOffset,
       onMouseEnter: this.props.onMouseEnter, // [Windows]
       onMouseLeave: this.props.onMouseLeave, // [Windows]
-      onBlur: (event) => {
+      onBlur: event => {
         if (Platform.isTV) {
           this._opacityInactive(250);
         }
@@ -154,7 +154,7 @@ class TouchableOpacity extends React.Component<Props, State> {
           this.props.onBlur(event);
         }
       },
-      onFocus: (event) => {
+      onFocus: event => {
         if (Platform.isTV) {
           this._opacityActive(150);
         }
@@ -164,7 +164,7 @@ class TouchableOpacity extends React.Component<Props, State> {
       },
       onLongPress: this.props.onLongPress,
       onPress: this.props.onPress,
-      onPressIn: (event) => {
+      onPressIn: event => {
         this._opacityActive(
           event.dispatchConfig.registrationName === 'onResponderGrant'
             ? 0
@@ -174,7 +174,7 @@ class TouchableOpacity extends React.Component<Props, State> {
           this.props.onPressIn(event);
         }
       },
-      onPressOut: (event) => {
+      onPressOut: event => {
         this._opacityInactive(250);
         if (this.props.onPressOut != null) {
           this.props.onPressOut(event);
@@ -232,6 +232,7 @@ class TouchableOpacity extends React.Component<Props, State> {
         accessible={this.props.accessible !== false}
         accessibilityLabel={this.props.accessibilityLabel}
         accessibilityHint={this.props.accessibilityHint}
+        accessibilityLanguage={this.props.accessibilityLanguage}
         accessibilityRole={this.props.accessibilityRole}
         accessibilityState={accessibilityState}
         accessibilityActions={this.props.accessibilityActions}
@@ -274,7 +275,12 @@ class TouchableOpacity extends React.Component<Props, State> {
 
   componentDidUpdate(prevProps: Props, prevState: State) {
     this.state.pressability.configure(this._createPressabilityConfig());
-    if (this.props.disabled !== prevProps.disabled) {
+    if (
+      this.props.disabled !== prevProps.disabled ||
+      (flattenStyle(prevProps.style)?.opacity !==
+        flattenStyle(this.props.style)?.opacity) !==
+        undefined
+    ) {
       this._opacityInactive(250);
     }
   }

package/Libraries/Components/Touchable/TouchableWithoutFeedback.js

@@ -33,6 +33,7 @@ type Props = $ReadOnly<{|
   accessibilityActions?: ?$ReadOnlyArray<AccessibilityActionInfo>,
   accessibilityElementsHidden?: ?boolean,
   accessibilityHint?: ?Stringish,
+  accessibilityLanguage?: ?Stringish,
   accessibilityIgnoresInvertColors?: ?boolean,
   accessibilityLabel?: ?Stringish,
   accessibilityLiveRegion?: ?('none' | 'polite' | 'assertive'),
@@ -72,6 +73,7 @@ const PASSTHROUGH_PROPS = [
   'accessibilityActions',
   'accessibilityElementsHidden',
   'accessibilityHint',
+  'accessibilityLanguage',
   'accessibilityIgnoresInvertColors',
   'accessibilityLabel',
   'accessibilityLiveRegion',

package/Libraries/Components/Touchable/TouchableWithoutFeedback.windows.js

@@ -34,6 +34,7 @@ type Props = $ReadOnly<{|
   accessibilityActions?: ?$ReadOnlyArray<AccessibilityActionInfo>,
   accessibilityElementsHidden?: ?boolean,
   accessibilityHint?: ?Stringish,
+  accessibilityLanguage?: ?Stringish,
   accessibilityIgnoresInvertColors?: ?boolean,
   accessibilityLabel?: ?Stringish,
   accessibilityLiveRegion?: ?('none' | 'polite' | 'assertive'),
@@ -80,6 +81,7 @@ const PASSTHROUGH_PROPS = [
   'accessibilityActions',
   'accessibilityElementsHidden',
   'accessibilityHint',
+  'accessibilityLanguage',
   'accessibilityIgnoresInvertColors',
   'accessibilityLabel',
   'accessibilityLiveRegion',

package/Libraries/Components/View/ReactNativeViewAttributes.js

@@ -21,6 +21,7 @@ const UIView = {
   accessibilityState: true,
   accessibilityValue: true,
   accessibilityHint: true,
+  accessibilityLanguage: true,
   importantForAccessibility: true,
   nativeID: true,
   testID: true,

package/Libraries/Components/View/ReactNativeViewAttributes.windows.js

@@ -21,6 +21,7 @@ const UIView = {
   accessibilityState: true,
   accessibilityValue: true,
   accessibilityHint: true,
+  accessibilityLanguage: true,
   importantForAccessibility: true,
   nativeID: true,
   testID: true,

package/Libraries/Components/View/View.windows.js

@@ -75,13 +75,33 @@ const View: React.AbstractComponent<
     props.onKeyUpCapture && props.onKeyUpCapture(event);
   };
 
+  // [Windows
+  const childrenWithImportantForAccessibility = children => {
+    return React.Children.map(children, child => {
+      if (React.isValidElement(child)) {
+        if (child.props.children) {
+          return React.cloneElement(child, {
+            accessible: false,
+            children: childrenWithImportantForAccessibility(
+              child.props.children,
+            ),
+          });
+        } else {
+          return React.cloneElement(child, {accessible: false});
+        }
+      }
+      return child;
+    });
+  };
+  // Windows]
+
   return (
     // [Windows
     // In core this is a TextAncestor.Provider value={false} See
     // https://github.com/facebook/react-native/commit/66601e755fcad10698e61d20878d52194ad0e90c
     // But since Views are not currently supported in Text, we do not need the extra provider
     <TextAncestor.Consumer>
-      {(hasTextAncestor) => {
+      {hasTextAncestor => {
         invariant(
           !hasTextAncestor,
           'Nesting of <View> within <Text> is not currently supported.',
@@ -94,6 +114,18 @@ const View: React.AbstractComponent<
             onKeyDownCapture={_keyDownCapture}
             onKeyUp={_keyUp}
             onKeyUpCapture={_keyUpCapture}
+            // [Windows
+            accessible={
+              props.importantForAccessibility === 'no-hide-descendants'
+                ? false
+                : props.accessible
+            }
+            children={
+              props.importantForAccessibility === 'no-hide-descendants'
+                ? childrenWithImportantForAccessibility(props.children)
+                : props.children
+            }
+            // Windows]
           />
         );
       }}

package/Libraries/Components/View/ViewNativeComponent.js

@@ -9,19 +9,79 @@
  */
 
 import * as NativeComponentRegistry from '../../NativeComponent/NativeComponentRegistry';
-import {type HostComponent} from '../../Renderer/shims/ReactNativeTypes';
-import Platform from '../../Utilities/Platform';
+import type {
+  HostComponent,
+  PartialViewConfig,
+} from '../../Renderer/shims/ReactNativeTypes';
 import codegenNativeCommands from '../../Utilities/codegenNativeCommands';
-import ReactNativeViewViewConfigAndroid from './ReactNativeViewViewConfigAndroid';
 import {type ViewProps as Props} from './ViewPropTypes';
+import Platform from '../../Utilities/Platform';
+
 import * as React from 'react';
 
+export const __INTERNAL_VIEW_CONFIG: PartialViewConfig =
+  Platform.OS === 'android'
+    ? {
+        uiViewClassName: 'RCTView',
+        validAttributes: {
+          // ReactClippingViewManager @ReactProps
+          removeClippedSubviews: true,
+
+          // ReactViewManager @ReactProps
+          accessible: true,
+          hasTVPreferredFocus: true,
+          nextFocusDown: true,
+          nextFocusForward: true,
+          nextFocusLeft: true,
+          nextFocusRight: true,
+          nextFocusUp: true,
+
+          borderRadius: true,
+          borderTopLeftRadius: true,
+          borderTopRightRadius: true,
+          borderBottomRightRadius: true,
+          borderBottomLeftRadius: true,
+          borderTopStartRadius: true,
+          borderTopEndRadius: true,
+          borderBottomStartRadius: true,
+          borderBottomEndRadius: true,
+
+          borderStyle: true,
+          hitSlop: true,
+          pointerEvents: true,
+          nativeBackgroundAndroid: true,
+          nativeForegroundAndroid: true,
+          needsOffscreenAlphaCompositing: true,
+
+          borderWidth: true,
+          borderLeftWidth: true,
+          borderRightWidth: true,
+          borderTopWidth: true,
+          borderBottomWidth: true,
+          borderStartWidth: true,
+          borderEndWidth: true,
+
+          borderColor: {process: require('../../StyleSheet/processColor')},
+          borderLeftColor: {process: require('../../StyleSheet/processColor')},
+          borderRightColor: {process: require('../../StyleSheet/processColor')},
+          borderTopColor: {process: require('../../StyleSheet/processColor')},
+          borderBottomColor: {
+            process: require('../../StyleSheet/processColor'),
+          },
+          borderStartColor: {process: require('../../StyleSheet/processColor')},
+          borderEndColor: {process: require('../../StyleSheet/processColor')},
+
+          focusable: true,
+          overflow: true,
+          backfaceVisibility: true,
+        },
+      }
+    : {
+        uiViewClassName: 'RCTView',
+      };
+
 const ViewNativeComponent: HostComponent<Props> =
-  NativeComponentRegistry.get<Props>('RCTView', () =>
-    Platform.OS === 'android'
-      ? ReactNativeViewViewConfigAndroid
-      : {uiViewClassName: 'RCTView'},
-  );
+  NativeComponentRegistry.get<Props>('RCTView', () => __INTERNAL_VIEW_CONFIG);
 
 interface NativeCommands {
   +hotspotUpdate: (

package/Libraries/Components/View/ViewPropTypes.js

@@ -14,11 +14,12 @@ import type {
   BlurEvent,
   FocusEvent,
   MouseEvent,
+  PointerEvent,
   PressEvent,
   Layout,
   LayoutEvent,
 } from '../../Types/CoreEventTypes';
-import type {EdgeInsetsProp} from '../../StyleSheet/EdgeInsetsPropType';
+import type {EdgeInsetsOrSizeProp} from '../../StyleSheet/EdgeInsetsPropType';
 import type {Node} from 'react';
 import type {ViewStyleProp} from '../../StyleSheet/StyleSheet';
 import type {
@@ -84,8 +85,29 @@ type DirectEventProps = $ReadOnly<{|
 |}>;
 
 type MouseEventProps = $ReadOnly<{|
-  onMouseEnter?: (event: MouseEvent) => void,
-  onMouseLeave?: (event: MouseEvent) => void,
+  onMouseEnter?: ?(event: MouseEvent) => void,
+  onMouseLeave?: ?(event: MouseEvent) => void,
+|}>;
+
+// Experimental/Work in Progress Pointer Event Callbacks (not yet ready for use)
+type PointerEventProps = $ReadOnly<{|
+  onPointerEnter?: ?(event: PointerEvent) => void,
+  onPointerLeave?: ?(event: PointerEvent) => void,
+  onPointerMove?: ?(event: PointerEvent) => void,
+  onPointerCancel?: ?(e: PointerEvent) => void,
+  onPointerCancelCapture?: ?(e: PointerEvent) => void,
+  onPointerDown?: ?(e: PointerEvent) => void,
+  onPointerDownCapture?: ?(e: PointerEvent) => void,
+  onPointerUp?: ?(e: PointerEvent) => void,
+  onPointerUpCapture?: ?(e: PointerEvent) => void,
+
+  // FIXME: these events are temporary while we converge pointer event handling
+  onPointerEnter2?: ?(e: PointerEvent) => void,
+  onPointerEnter2Capture?: ?(e: PointerEvent) => void,
+  onPointerLeave2?: ?(e: PointerEvent) => void,
+  onPointerLeave2Capture?: ?(e: PointerEvent) => void,
+  onPointerMove2?: ?(e: PointerEvent) => void,
+  onPointerMove2Capture?: ?(e: PointerEvent) => void,
 |}>;
 
 type TouchEventProps = $ReadOnly<{|
@@ -381,6 +403,7 @@ export type ViewProps = $ReadOnly<{|
   ...DirectEventProps,
   ...GestureResponderEventProps,
   ...MouseEventProps,
+  ...PointerEventProps,
   ...TouchEventProps,
   ...AndroidViewProps,
   ...IOSViewProps,
@@ -415,6 +438,15 @@ export type ViewProps = $ReadOnly<{|
    */
   accessibilityHint?: ?Stringish,
 
+  /**
+   * Indicates to the accessibility services that the UI component is in
+   * a specific language. The provided string should be formatted following
+   * the BCP 47 specification (https://www.rfc-editor.org/info/bcp47).
+   *
+   * @platform ios
+   */
+  accessibilityLanguage?: ?Stringish,
+
   /**
    * Indicates to accessibility services to treat UI component like a specific role.
    */
@@ -481,7 +513,7 @@ export type ViewProps = $ReadOnly<{|
    *
    * See https://reactnative.dev/docs/view#hitslop
    */
-  hitSlop?: ?EdgeInsetsProp,
+  hitSlop?: ?EdgeInsetsOrSizeProp,
 
   /**
    * Controls whether the `View` can be the target of touch events.

package/Libraries/Components/View/ViewPropTypes.windows.js

@@ -14,12 +14,13 @@ import type {
   BlurEvent,
   FocusEvent,
   MouseEvent,
+  PointerEvent,
   PressEvent,
   Layout,
   LayoutEvent,
   KeyEvent, // [Windows]
 } from '../../Types/CoreEventTypes';
-import type {EdgeInsetsProp} from '../../StyleSheet/EdgeInsetsPropType';
+import type {EdgeInsetsOrSizeProp} from '../../StyleSheet/EdgeInsetsPropType';
 import type {Node} from 'react';
 import type {ViewStyleProp} from '../../StyleSheet/StyleSheet';
 import type {
@@ -85,8 +86,29 @@ type DirectEventProps = $ReadOnly<{|
 |}>;
 
 type MouseEventProps = $ReadOnly<{|
-  onMouseEnter?: (event: MouseEvent) => void,
-  onMouseLeave?: (event: MouseEvent) => void,
+  onMouseEnter?: ?(event: MouseEvent) => void,
+  onMouseLeave?: ?(event: MouseEvent) => void,
+|}>;
+
+// Experimental/Work in Progress Pointer Event Callbacks (not yet ready for use)
+type PointerEventProps = $ReadOnly<{|
+  onPointerEnter?: ?(event: PointerEvent) => void,
+  onPointerLeave?: ?(event: PointerEvent) => void,
+  onPointerMove?: ?(event: PointerEvent) => void,
+  onPointerCancel?: ?(e: PointerEvent) => void,
+  onPointerCancelCapture?: ?(e: PointerEvent) => void,
+  onPointerDown?: ?(e: PointerEvent) => void,
+  onPointerDownCapture?: ?(e: PointerEvent) => void,
+  onPointerUp?: ?(e: PointerEvent) => void,
+  onPointerUpCapture?: ?(e: PointerEvent) => void,
+
+  // FIXME: these events are temporary while we converge pointer event handling
+  onPointerEnter2?: ?(e: PointerEvent) => void,
+  onPointerEnter2Capture?: ?(e: PointerEvent) => void,
+  onPointerLeave2?: ?(e: PointerEvent) => void,
+  onPointerLeave2Capture?: ?(e: PointerEvent) => void,
+  onPointerMove2?: ?(e: PointerEvent) => void,
+  onPointerMove2Capture?: ?(e: PointerEvent) => void,
 |}>;
 
 type TouchEventProps = $ReadOnly<{|
@@ -429,6 +451,7 @@ export type ViewProps = $ReadOnly<{|
   ...DirectEventProps,
   ...GestureResponderEventProps,
   ...MouseEventProps,
+  ...PointerEventProps,
   ...TouchEventProps,
   ...AndroidViewProps,
   ...IOSViewProps,
@@ -464,6 +487,15 @@ export type ViewProps = $ReadOnly<{|
    */
   accessibilityHint?: ?Stringish,
 
+  /**
+   * Indicates to the accessibility services that the UI component is in
+   * a specific language. The provided string should be formatted following
+   * the BCP 47 specification (https://www.rfc-editor.org/info/bcp47).
+   *
+   * @platform ios
+   */
+  accessibilityLanguage?: ?Stringish,
+
   /**
    * Indicates to accessibility services to treat UI component like a specific role.
    */
@@ -530,7 +562,7 @@ export type ViewProps = $ReadOnly<{|
    *
    * See https://reactnative.dev/docs/view#hitslop
    */
-  hitSlop?: ?EdgeInsetsProp,
+  hitSlop?: ?EdgeInsetsOrSizeProp,
 
   /**
    * Controls whether the `View` can be the target of touch events.

package/Libraries/Core/Devtools/parseHermesStack.js

@@ -100,7 +100,7 @@ function parseLine(line: string): ?HermesStackEntry {
 
 module.exports = function parseHermesStack(stack: string): HermesParsedStack {
   const lines = stack.split(/\n/);
-  let entries = [];
+  let entries: Array<HermesStackEntryFrame | HermesStackEntrySkipped> = [];
   let lastMessageLine = -1;
   for (let i = 0; i < lines.length; ++i) {
     const line = lines[i];

package/Libraries/Core/ExceptionsManager.js

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  *
  * @format
- * @flow strict-local
+ * @flow strict
  */
 
 'use strict';

package/Libraries/Core/RawEventEmitter.js

@@ -0,0 +1,38 @@
+/**
+ * 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 EventEmitter from '../vendor/emitter/EventEmitter';
+import type {IEventEmitter} from '../vendor/emitter/EventEmitter';
+
+export type RawEventEmitterEvent = $ReadOnly<{|
+  eventName: string,
+  // We expect, but do not/cannot require, that nativeEvent is an object
+  // with the properties: key, elementType (string), type (string), tag (numeric),
+  // and a stateNode of the native element/Fiber the event was emitted to.
+  nativeEvent: {[string]: mixed},
+|}>;
+
+type RawEventDefinitions = {
+  [eventChannel: string]: [RawEventEmitterEvent],
+};
+
+const RawEventEmitter: IEventEmitter<RawEventDefinitions> =
+  new EventEmitter<RawEventDefinitions>();
+
+// See the React renderer / react repo for how this is used.
+// Raw events are emitted here when they are received in JS
+// and before any event Plugins process them or before components
+// have a chance to respond to them. This allows you to implement
+// app-specific perf monitoring, which is unimplemented by default,
+// making this entire RawEventEmitter do nothing by default until
+// *you* add listeners for your own app.
+// Besides perf monitoring and maybe debugging, this RawEventEmitter
+// should not be used.
+export default RawEventEmitter;

package/Libraries/Core/ReactNativeVersion.js

@@ -11,7 +11,7 @@
 
 exports.version = {
   major: 0,
-  minor: 68,
+  minor: 69,
   patch: 0,
-  prerelease: null,
+  prerelease: 'rc.0',
 };

package/Libraries/Core/polyfillPromise.js

@@ -11,6 +11,7 @@
 'use strict';
 
 const {polyfillGlobal} = require('../Utilities/PolyfillFunctions');
+const warnOnce = require('../Utilities/warnOnce');
 
 /**
  * Set up Promise. The native Promise implementation throws the following error:
@@ -36,3 +37,34 @@ if (global?.HermesInternal?.hasPromise?.()) {
 } else {
   polyfillGlobal('Promise', () => require('../Promise'));
 }
+
+if (__DEV__) {
+  // $FlowFixMe
+  const done = Promise.prototype.done;
+  if (done != null) {
+    let depth = 0;
+    /* eslint-disable no-extend-native */
+    // $FlowFixMe
+    Promise.prototype.done = function () {
+      ++depth;
+      try {
+        // Avoid infinite recursion if done() happens to be triggered by warnOnce.
+        if (depth === 1) {
+          // Warn once per unique call stack. Not super efficient, but we're in
+          // __DEV__ and .done() calls are rare to begin with.
+          const key = new Error().stack;
+          warnOnce(
+            key,
+            'Promise.prototype.done(): This nonstandard polyfill ' +
+              'has been deprecated and will be removed in a future release. ' +
+              'Please instead use `.then()`.',
+          );
+        }
+      } finally {
+        --depth;
+      }
+      return done.apply(this, arguments);
+    };
+    /* eslint-enable no-extend-native */
+  }
+}

package/Libraries/Core/setUpReactDevTools.js

@@ -58,12 +58,13 @@ if (__DEV__) {
         isWebSocketOpen = true;
       });
 
-      const viewConfig = require('../Components/View/ReactNativeViewViewConfig');
+      const ReactNativeStyleAttributes = require('../Components/View/ReactNativeStyleAttributes');
+
       reactDevTools.connectToDevTools({
         isAppActive,
         resolveRNStyle: require('../StyleSheet/flattenStyle'),
         nativeStyleEditorValidAttributes: Object.keys(
-          viewConfig.validAttributes.style,
+          ReactNativeStyleAttributes,
         ),
         websocket: ws,
       });

package/Libraries/EventEmitter/NativeEventEmitter.js

@@ -10,9 +10,9 @@
 
 'use strict';
 
-import {
-  type EventSubscription,
-  type IEventEmitter,
+import type {
+  EventSubscription,
+  IEventEmitter,
 } from '../vendor/emitter/EventEmitter';
 import Platform from '../Utilities/Platform';
 import RCTDeviceEventEmitter from './RCTDeviceEventEmitter';

package/Libraries/EventEmitter/RCTDeviceEventEmitter.js

@@ -8,7 +8,8 @@
  * @format
  */
 
-import EventEmitter, {type IEventEmitter} from '../vendor/emitter/EventEmitter';
+import EventEmitter from '../vendor/emitter/EventEmitter';
+import type {IEventEmitter} from '../vendor/emitter/EventEmitter';
 
 // FIXME: use typed events
 type RCTDeviceEventDefinitions = $FlowFixMe;

package/Libraries/EventEmitter/__mocks__/NativeEventEmitter.js

@@ -8,9 +8,9 @@
  * @flow strict-local
  */
 
-import {
-  type EventSubscription,
-  type IEventEmitter,
+import type {
+  EventSubscription,
+  IEventEmitter,
 } from '../../vendor/emitter/EventEmitter';
 import RCTDeviceEventEmitter from '../RCTDeviceEventEmitter';
 

package/Libraries/Events/CustomEvent.js

@@ -0,0 +1,32 @@
+/**
+ * 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
+ */
+
+// Make sure global Event is defined
+import EventPolyfill from './EventPolyfill';
+
+type CustomEvent$Options = $ReadOnly<{|
+  bubbles?: boolean,
+  cancelable?: boolean,
+  composed?: boolean,
+  detail?: {...},
+|}>;
+
+class CustomEvent extends EventPolyfill {
+  detail: ?{...};
+
+  constructor(typeArg: string, options: CustomEvent$Options) {
+    const {bubbles, cancelable, composed} = options;
+    super(typeArg, {bubbles, cancelable, composed});
+
+    this.detail = options.detail; // this would correspond to `NativeEvent` in SyntheticEvent
+  }
+}
+
+export default CustomEvent;