@react-native-oh/react-native-harmony 0.72.86 → 0.77.18-1

package/Libraries/Types/CoreEventTypes.d.ts

@@ -0,0 +1,259 @@
+/**
+ * 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 * as React from 'react';
+import {HostInstance} from '../../types/public/ReactNativeTypes';
+
+export interface LayoutRectangle {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+// @see TextProps.onLayout
+export type LayoutChangeEvent = NativeSyntheticEvent<{layout: LayoutRectangle}>;
+
+interface TextLayoutLine {
+  ascender: number;
+  capHeight: number;
+  descender: number;
+  height: number;
+  text: string;
+  width: number;
+  x: number;
+  xHeight: number;
+  y: number;
+}
+
+/**
+ * @see TextProps.onTextLayout
+ */
+export interface TextLayoutEventData extends TargetedEvent {
+  lines: TextLayoutLine[];
+}
+
+// Similar to React.SyntheticEvent except for nativeEvent
+export interface NativeSyntheticEvent<T>
+  extends React.BaseSyntheticEvent<T, HostInstance, HostInstance> {}
+
+export interface NativeTouchEvent {
+  /**
+   * Array of all touch events that have changed since the last event
+   */
+  changedTouches: NativeTouchEvent[];
+
+  /**
+   * The ID of the touch
+   */
+  identifier: string;
+
+  /**
+   * The X position of the touch, relative to the element
+   */
+  locationX: number;
+
+  /**
+   * The Y position of the touch, relative to the element
+   */
+  locationY: number;
+
+  /**
+   * The X position of the touch, relative to the screen
+   */
+  pageX: number;
+
+  /**
+   * The Y position of the touch, relative to the screen
+   */
+  pageY: number;
+
+  /**
+   * The node id of the element receiving the touch event
+   */
+  target: string;
+
+  /**
+   * A time identifier for the touch, useful for velocity calculation
+   */
+  timestamp: number;
+
+  /**
+   * Array of all current touches on the screen
+   */
+  touches: NativeTouchEvent[];
+
+  /**
+   * 3D Touch reported force
+   * @platform ios
+   */
+  force?: number | undefined;
+}
+
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/API/UIEvent
+ */
+export interface NativeUIEvent {
+  /**
+   * Returns a long with details about the event, depending on the event type.
+   */
+  readonly detail: number;
+}
+
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent
+ */
+export interface NativeMouseEvent extends NativeUIEvent {
+  /**
+   * The X coordinate of the mouse pointer in global (screen) coordinates.
+   */
+  readonly screenX: number;
+  /**
+   * The Y coordinate of the mouse pointer in global (screen) coordinates.
+   */
+  readonly screenY: number;
+  /**
+   * The X coordinate of the mouse pointer relative to the whole document.
+   */
+  readonly pageX: number;
+  /**
+   * The Y coordinate of the mouse pointer relative to the whole document.
+   */
+  readonly pageY: number;
+  /**
+   * The X coordinate of the mouse pointer in local (DOM content) coordinates.
+   */
+  readonly clientX: number;
+  /**
+   * The Y coordinate of the mouse pointer in local (DOM content) coordinates.
+   */
+  readonly clientY: number;
+  /**
+   * Alias for NativeMouseEvent.clientX
+   */
+  readonly x: number;
+  /**
+   * Alias for NativeMouseEvent.clientY
+   */
+  readonly y: number;
+  /**
+   * Returns true if the control key was down when the mouse event was fired.
+   */
+  readonly ctrlKey: boolean;
+  /**
+   * Returns true if the shift key was down when the mouse event was fired.
+   */
+  readonly shiftKey: boolean;
+  /**
+   * Returns true if the alt key was down when the mouse event was fired.
+   */
+  readonly altKey: boolean;
+  /**
+   * Returns true if the meta key was down when the mouse event was fired.
+   */
+  readonly metaKey: boolean;
+  /**
+   * The button number that was pressed (if applicable) when the mouse event was fired.
+   */
+  readonly button: number;
+  /**
+   * The buttons being depressed (if any) when the mouse event was fired.
+   */
+  readonly buttons: number;
+  /**
+   * The secondary target for the event, if there is one.
+   */
+  readonly relatedTarget: null | number | HostInstance;
+  // offset is proposed: https://drafts.csswg.org/cssom-view/#extensions-to-the-mouseevent-interface
+  /**
+   * The X coordinate of the mouse pointer between that event and the padding edge of the target node
+   */
+  readonly offsetX: number;
+  /**
+   * The Y coordinate of the mouse pointer between that event and the padding edge of the target node
+   */
+  readonly offsetY: number;
+}
+
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent
+ */
+export interface NativePointerEvent extends NativeMouseEvent {
+  /**
+   * A unique identifier for the pointer causing the event.
+   */
+  readonly pointerId: number;
+  /**
+   * The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer
+   */
+  readonly width: number;
+  /**
+   * The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer.
+   */
+  readonly height: number;
+  /**
+   * The normalized pressure of the pointer input in the range 0 to 1, where 0 and 1 represent
+   * the minimum and maximum pressure the hardware is capable of detecting, respectively.
+   */
+  readonly pressure: number;
+  /**
+   * The normalized tangential pressure of the pointer input (also known as barrel pressure or
+   * cylinder stress) in the range -1 to 1, where 0 is the neutral position of the control.
+   */
+  readonly tangentialPressure: number;
+  /**
+   * The plane angle (in degrees, in the range of -90 to 90) between the Y–Z plane and the plane
+   * containing both the pointer (e.g. pen stylus) axis and the Y axis.
+   */
+  readonly tiltX: number;
+  /**
+   * The plane angle (in degrees, in the range of -90 to 90) between the X–Z plane and the plane
+   * containing both the pointer (e.g. pen stylus) axis and the X axis.
+   */
+  readonly tiltY: number;
+  /**
+   * The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees,
+   * with a value in the range 0 to 359.
+   */
+  readonly twist: number;
+  /**
+   * Indicates the device type that caused the event (mouse, pen, touch, etc.)
+   */
+  readonly pointerType: string;
+  /**
+   * Indicates if the pointer represents the primary pointer of this pointer type.
+   */
+  readonly isPrimary: boolean;
+}
+
+export type PointerEvent = NativeSyntheticEvent<NativePointerEvent>;
+
+export interface GestureResponderEvent
+  extends NativeSyntheticEvent<NativeTouchEvent> {}
+
+export interface MouseEvent extends NativeSyntheticEvent<NativeMouseEvent> {}
+
+export interface TargetedEvent {
+  target: number;
+}
+
+export interface PointerEvents {
+  onPointerEnter?: ((event: PointerEvent) => void) | undefined;
+  onPointerEnterCapture?: ((event: PointerEvent) => void) | undefined;
+  onPointerLeave?: ((event: PointerEvent) => void) | undefined;
+  onPointerLeaveCapture?: ((event: PointerEvent) => void) | undefined;
+  onPointerMove?: ((event: PointerEvent) => void) | undefined;
+  onPointerMoveCapture?: ((event: PointerEvent) => void) | undefined;
+  onPointerCancel?: ((event: PointerEvent) => void) | undefined;
+  onPointerCancelCapture?: ((event: PointerEvent) => void) | undefined;
+  onPointerDown?: ((event: PointerEvent) => void) | undefined;
+  onPointerDownCapture?: ((event: PointerEvent) => void) | undefined;
+  onPointerUp?: ((event: PointerEvent) => void) | undefined;
+  onPointerUpCapture?: ((event: PointerEvent) => void) | undefined;
+}

package/Libraries/Types/CoreEventTypes.js

@@ -0,0 +1,291 @@
+/**
+ * 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 type {HostInstance} from '../Renderer/shims/ReactNativeTypes';
+
+export type SyntheticEvent<+T> = $ReadOnly<{|
+  bubbles: ?boolean,
+  cancelable: ?boolean,
+  currentTarget: number | HostInstance,
+  defaultPrevented: ?boolean,
+  dispatchConfig: $ReadOnly<{|
+    registrationName: string,
+  |}>,
+  eventPhase: ?number,
+  preventDefault: () => void,
+  isDefaultPrevented: () => boolean,
+  stopPropagation: () => void,
+  isPropagationStopped: () => boolean,
+  isTrusted: ?boolean,
+  nativeEvent: T,
+  persist: () => void,
+  target: ?number | HostInstance,
+  timeStamp: number,
+  type: ?string,
+|}>;
+
+export type ResponderSyntheticEvent<T> = $ReadOnly<{|
+  ...SyntheticEvent<T>,
+  touchHistory: $ReadOnly<{|
+    indexOfSingleActiveTouch: number,
+    mostRecentTimeStamp: number,
+    numberActiveTouches: number,
+    touchBank: $ReadOnlyArray<
+      $ReadOnly<{|
+        touchActive: boolean,
+        startPageX: number,
+        startPageY: number,
+        startTimeStamp: number,
+        currentPageX: number,
+        currentPageY: number,
+        currentTimeStamp: number,
+        previousPageX: number,
+        previousPageY: number,
+        previousTimeStamp: number,
+      |}>,
+    >,
+  |}>,
+|}>;
+
+export type Layout = $ReadOnly<{|
+  x: number,
+  y: number,
+  width: number,
+  height: number,
+|}>;
+
+export type TextLayout = $ReadOnly<{|
+  ...Layout,
+  ascender: number,
+  capHeight: number,
+  descender: number,
+  text: string,
+  xHeight: number,
+|}>;
+
+export type LayoutEvent = SyntheticEvent<
+  $ReadOnly<{|
+    layout: Layout,
+  |}>,
+>;
+
+export type TextLayoutEvent = SyntheticEvent<
+  $ReadOnly<{|
+    lines: Array<TextLayout>,
+  |}>,
+>;
+
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/API/UIEvent
+ */
+export interface NativeUIEvent {
+  /**
+   * Returns a long with details about the event, depending on the event type.
+   */
+  +detail: number;
+}
+
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent
+ */
+export interface NativeMouseEvent extends NativeUIEvent {
+  /**
+   * The X coordinate of the mouse pointer in global (screen) coordinates.
+   */
+  +screenX: number;
+  /**
+   * The Y coordinate of the mouse pointer in global (screen) coordinates.
+   */
+  +screenY: number;
+  /**
+   * The X coordinate of the mouse pointer relative to the whole document.
+   */
+  +pageX: number;
+  /**
+   * The Y coordinate of the mouse pointer relative to the whole document.
+   */
+  +pageY: number;
+  /**
+   * The X coordinate of the mouse pointer in local (DOM content) coordinates.
+   */
+  +clientX: number;
+  /**
+   * The Y coordinate of the mouse pointer in local (DOM content) coordinates.
+   */
+  +clientY: number;
+  /**
+   * Alias for NativeMouseEvent.clientX
+   */
+  +x: number;
+  /**
+   * Alias for NativeMouseEvent.clientY
+   */
+  +y: number;
+  /**
+   * Returns true if the control key was down when the mouse event was fired.
+   */
+  +ctrlKey: boolean;
+  /**
+   * Returns true if the shift key was down when the mouse event was fired.
+   */
+  +shiftKey: boolean;
+  /**
+   * Returns true if the alt key was down when the mouse event was fired.
+   */
+  +altKey: boolean;
+  /**
+   * Returns true if the meta key was down when the mouse event was fired.
+   */
+  +metaKey: boolean;
+  /**
+   * The button number that was pressed (if applicable) when the mouse event was fired.
+   */
+  +button: number;
+  /**
+   * The buttons being depressed (if any) when the mouse event was fired.
+   */
+  +buttons: number;
+  /**
+   * The secondary target for the event, if there is one.
+   */
+  +relatedTarget: null | number | HostInstance;
+  // offset is proposed: https://drafts.csswg.org/cssom-view/#extensions-to-the-mouseevent-interface
+  /**
+   * The X coordinate of the mouse pointer between that event and the padding edge of the target node
+   */
+  +offsetX: number;
+  /**
+   * The Y coordinate of the mouse pointer between that event and the padding edge of the target node
+   */
+  +offsetY: number;
+}
+
+/**
+ * https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent
+ */
+export interface NativePointerEvent extends NativeMouseEvent {
+  /**
+   * A unique identifier for the pointer causing the event.
+   */
+  +pointerId: number;
+  /**
+   * The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer
+   */
+  +width: number;
+  /**
+   * The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer.
+   */
+  +height: number;
+  /**
+   * The normalized pressure of the pointer input in the range 0 to 1, where 0 and 1 represent
+   * the minimum and maximum pressure the hardware is capable of detecting, respectively.
+   */
+  +pressure: number;
+  /**
+   * The normalized tangential pressure of the pointer input (also known as barrel pressure or
+   * cylinder stress) in the range -1 to 1, where 0 is the neutral position of the control.
+   */
+  +tangentialPressure: number;
+  /**
+   * The plane angle (in degrees, in the range of -90 to 90) between the Y–Z plane and the plane
+   * containing both the pointer (e.g. pen stylus) axis and the Y axis.
+   */
+  +tiltX: number;
+  /**
+   * The plane angle (in degrees, in the range of -90 to 90) between the X–Z plane and the plane
+   * containing both the pointer (e.g. pen stylus) axis and the X axis.
+   */
+  +tiltY: number;
+  /**
+   * The clockwise rotation of the pointer (e.g. pen stylus) around its major axis in degrees,
+   * with a value in the range 0 to 359.
+   */
+  +twist: number;
+  /**
+   * Indicates the device type that caused the event (mouse, pen, touch, etc.)
+   */
+  +pointerType: string;
+  /**
+   * Indicates if the pointer represents the primary pointer of this pointer type.
+   */
+  +isPrimary: boolean;
+}
+
+export type PointerEvent = SyntheticEvent<NativePointerEvent>;
+
+export type PressEvent = ResponderSyntheticEvent<
+  $ReadOnly<{|
+    changedTouches: $ReadOnlyArray<$PropertyType<PressEvent, 'nativeEvent'>>,
+    force?: number,
+    identifier: number,
+    locationX: number,
+    locationY: number,
+    pageX: number,
+    pageY: number,
+    target: ?number,
+    timestamp: number,
+    touches: $ReadOnlyArray<$PropertyType<PressEvent, 'nativeEvent'>>,
+  |}>,
+>;
+
+export type ScrollEvent = SyntheticEvent<
+  $ReadOnly<{|
+    contentInset: $ReadOnly<{|
+      bottom: number,
+      left: number,
+      right: number,
+      top: number,
+    |}>,
+    contentOffset: $ReadOnly<{|
+      y: number,
+      x: number,
+    |}>,
+    contentSize: $ReadOnly<{|
+      height: number,
+      width: number,
+    |}>,
+    layoutMeasurement: $ReadOnly<{|
+      height: number,
+      width: number,
+    |}>,
+    targetContentOffset?: $ReadOnly<{|
+      y: number,
+      x: number,
+    |}>,
+    velocity?: $ReadOnly<{|
+      y: number,
+      x: number,
+    |}>,
+    zoomScale?: number,
+    responderIgnoreScroll?: boolean,
+  |}>,
+>;
+
+export type BlurEvent = SyntheticEvent<
+  $ReadOnly<{|
+    target: number,
+  |}>,
+>;
+
+export type FocusEvent = SyntheticEvent<
+  $ReadOnly<{|
+    target: number,
+  |}>,
+>;
+
+export type MouseEvent = SyntheticEvent<
+  $ReadOnly<{|
+    clientX: number,
+    clientY: number,
+    pageX: number,
+    pageY: number,
+    timestamp: number,
+  |}>,
+>;

package/Libraries/Types/ReactDevToolsTypes.js

@@ -0,0 +1,58 @@
+/**
+ * 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 {NativeMethods} from '../Renderer/shims/ReactNativeTypes';
+
+type PublicInstance = {
+  ...NativeMethods,
+};
+
+export type InstanceFromReactDevTools =
+  | PublicInstance
+  | {
+      canonical?:
+        | PublicInstance // TODO: remove this variant when syncing the new version of the renderer from React to React Native.
+        | {
+            publicInstance?: PublicInstance,
+          },
+    };
+
+export type ReactDevToolsAgentEvents = {
+  drawTraceUpdates: [Array<{node: InstanceFromReactDevTools, color: string}>],
+  disableTraceUpdates: [],
+
+  showNativeHighlight: [nodes: Array<InstanceFromReactDevTools>],
+  hideNativeHighlight: [],
+  shutdown: [],
+  startInspectingNative: [],
+  stopInspectingNative: [],
+};
+
+export type ReactDevToolsAgent = {
+  selectNode(node: mixed): void,
+  stopInspectingNative(value: boolean): void,
+  addListener<Event: $Keys<ReactDevToolsAgentEvents>>(
+    event: Event,
+    listener: (...ReactDevToolsAgentEvents[Event]) => void,
+  ): void,
+  removeListener(
+    event: $Keys<ReactDevToolsAgentEvents>,
+    listener: () => void,
+  ): void,
+};
+
+export type ReactDevToolsGlobalHook = {
+  on: (eventName: string, (agent: ReactDevToolsAgent) => void) => void,
+  off: (eventName: string, (agent: ReactDevToolsAgent) => void) => void,
+  reactDevtoolsAgent?: ReactDevToolsAgent,
+  resolveRNStyle?: mixed,
+  nativeStyleEditorValidAttributes?: Array<string>,
+};

package/Libraries/Types/RootTagTypes.js

@@ -0,0 +1,11 @@
+/**
+ * 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
+ */
+
+export type {RootTag} from '../ReactNative/RootTag';

package/Libraries/Types/UIManagerJSInterface.js

@@ -0,0 +1,16 @@
+/**
+ * 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
+ * @format
+ */
+
+import type {Spec} from '../ReactNative/NativeUIManager';
+
+export interface UIManagerJSInterface extends Spec {
+  +getViewManagerConfig: (viewManagerName: string) => Object;
+  +hasViewManagerConfig: (viewManagerName: string) => boolean;
+}

package/Libraries/UTFSequence.js

@@ -0,0 +1,56 @@
+/**
+ * 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
+ */
+
+'use strict';
+
+const deepFreezeAndThrowOnMutationInDev = require('./Utilities/deepFreezeAndThrowOnMutationInDev');
+
+/**
+ * A collection of Unicode sequences for various characters and emoji.
+ *
+ *  - More explicit than using the sequences directly in code.
+ *  - Source code should be limited to ASCII.
+ *  - Less chance of typos.
+ */
+const UTFSequence: {|
+  BOM: string,
+  BULLET: string,
+  BULLET_SP: string,
+  MDASH: string,
+  MDASH_SP: string,
+  MIDDOT: string,
+  MIDDOT_KATAKANA: string,
+  MIDDOT_SP: string,
+  NBSP: string,
+  NDASH: string,
+  NDASH_SP: string,
+  NEWLINE: string,
+  PIZZA: string,
+  TRIANGLE_LEFT: string,
+  TRIANGLE_RIGHT: string,
+|} = deepFreezeAndThrowOnMutationInDev({
+  BOM: '\ufeff', // byte order mark
+  BULLET: '\u2022', // bullet: •
+  BULLET_SP: '\u00A0\u2022\u00A0', //  • 
+  MIDDOT: '\u00B7', // normal middle dot: ·
+  MIDDOT_SP: '\u00A0\u00B7\u00A0', //  · 
+  MIDDOT_KATAKANA: '\u30FB', // katakana middle dot
+  MDASH: '\u2014', // em dash: —
+  MDASH_SP: '\u00A0\u2014\u00A0', //  — 
+  NDASH: '\u2013', // en dash: –
+  NDASH_SP: '\u00A0\u2013\u00A0', //  – 
+  NEWLINE: '\u000A',
+  NBSP: '\u00A0', // non-breaking space:  
+  PIZZA: '\uD83C\uDF55',
+  TRIANGLE_LEFT: '\u25c0', // black left-pointing triangle
+  TRIANGLE_RIGHT: '\u25b6', // black right-pointing triangle
+});
+
+export default UTFSequence;