react-native-tvos 0.86.0-2 → 0.87.0-0

package/Libraries/StyleSheet/private/_TransformStyle.js

@@ -51,29 +51,31 @@ export type ____TransformStyle_Internal = Readonly<{
         Readonly<
           MaximumOneOf<
             MergeUnion<
-              | {+perspective: number | AnimatedNode}
-              | {+rotate: string | AnimatedNode}
-              | {+rotateX: string | AnimatedNode}
-              | {+rotateY: string | AnimatedNode}
-              | {+rotateZ: string | AnimatedNode}
-              | {+scale: number | AnimatedNode}
-              | {+scaleX: number | AnimatedNode}
-              | {+scaleY: number | AnimatedNode}
-              | {+translateX: number | string | AnimatedNode}
-              | {+translateY: number | string | AnimatedNode}
+              | {readonly perspective: number | AnimatedNode}
+              | {readonly rotate: string | AnimatedNode}
+              | {readonly rotateX: string | AnimatedNode}
+              | {readonly rotateY: string | AnimatedNode}
+              | {readonly rotateZ: string | AnimatedNode}
+              | {readonly scale: number | AnimatedNode}
+              | {readonly scaleX: number | AnimatedNode}
+              | {readonly scaleY: number | AnimatedNode}
+              | {readonly translateX: number | string | AnimatedNode}
+              | {readonly translateY: number | string | AnimatedNode}
               | {
-                  +translate:
+                  readonly translate:
                     | [
                         number | string | AnimatedNode,
                         number | string | AnimatedNode,
                       ]
                     | AnimatedNode,
                 }
-              | {+skewX: string | AnimatedNode}
-              | {+skewY: string | AnimatedNode}
+              | {readonly skewX: string | AnimatedNode}
+              | {readonly skewY: string | AnimatedNode}
               // TODO: what is the actual type it expects?
               | {
-                  +matrix: ReadonlyArray<number | AnimatedNode> | AnimatedNode,
+                  readonly matrix:
+                    | ReadonlyArray<number | AnimatedNode>
+                    | AnimatedNode,
                 },
             >,
           >,

package/Libraries/Text/Text.js

@@ -8,6 +8,7 @@
  * @format
  */
 
+import type {HostInstance} from '../../src/private/types/HostInstance';
 import type {TextStyleProp} from '../StyleSheet/StyleSheet';
 import type {____TextStyle_Internal as TextStyleInternal} from '../StyleSheet/StyleSheetTypes';
 import type {GestureResponderEvent} from '../Types/CoreEventTypes';
@@ -30,19 +31,21 @@ import {
 import * as React from 'react';
 import {useContext, useMemo, useState} from 'react';
 
-export type {TextProps} from './TextProps';
+export type TextInstance = HostInstance;
 
-type TextForwardRef = React.ElementRef<
-  typeof NativeText | typeof NativeVirtualText | typeof NativeSelectableText,
->;
+export type {TextProps} from './TextProps';
 
 /**
- * Text is the fundamental component for displaying text.
+ * A React component for displaying text. `Text` supports nesting, styling,
+ * and touch handling.
+ *
+ * `Text` uses text layout instead of flexbox — elements inside wrap at end of
+ * line rather than being positioned as rectangles.
  *
  * @see https://reactnative.dev/docs/text
  */
 const TextImpl: component(
-  ref?: React.RefSetter<TextForwardRef>,
+  ref?: React.RefSetter<TextInstance>,
   ...props: TextProps
 ) = ({
   ref: forwardedRef,
@@ -82,7 +85,7 @@ const TextImpl: component(
   style,
   ...restProps
 }: {
-  ref?: React.RefSetter<TextForwardRef>,
+  ref?: React.RefSetter<TextInstance>,
   ...TextProps,
 }) => {
   const processedProps = restProps as {
@@ -480,7 +483,7 @@ function useTextPressability({
  * expensive pressability logic to be only initialized when needed.
  */
 component PressableVirtualText(
-  ref?: React.RefSetter<TextForwardRef>,
+  ref?: React.RefSetter<TextInstance>,
   textProps: NativeTextProps,
   textPressabilityProps: TextPressabilityProps,
 ) {
@@ -506,7 +509,7 @@ component PressableVirtualText(
  * expensive pressability logic to be only initialized when needed.
  */
 component PressableText(
-  ref?: React.RefSetter<TextForwardRef>,
+  ref?: React.RefSetter<TextInstance>,
   selectable?: ?boolean,
   textProps: NativeTextProps,
   textPressabilityProps: TextPressabilityProps,

package/Libraries/Text/TextEffectNativeComponent.js

@@ -0,0 +1,31 @@
+/**
+ * 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 {HostComponent} from '../../src/private/types/HostComponent';
+
+import * as NativeComponentRegistry from '../NativeComponent/NativeComponentRegistry';
+import * as React from 'react';
+
+type NativeTextEffectProps = Readonly<{
+  effectName?: ?string,
+  effectProps?: ?Readonly<{readonly [string]: unknown}>,
+  children?: React.Node,
+}>;
+
+const NativeTextEffect: HostComponent<NativeTextEffectProps> =
+  NativeComponentRegistry.get<NativeTextEffectProps>('RCTTextEffect', () => ({
+    validAttributes: {
+      effectName: true,
+      effectProps: true,
+    },
+    uiViewClassName: 'RCTTextEffect',
+  }));
+
+export default NativeTextEffect;

package/Libraries/Text/TextInput/Multiline/RCTUITextView.mm

@@ -11,7 +11,6 @@
 #import <React/UIView+React.h>
 
 #import <React/RCTBackedTextInputDelegateAdapter.h>
-#import <React/RCTTextAttributes.h>
 
 @implementation RCTUITextView {
   UILabel *_placeholderView;

package/Libraries/Text/TextInput/RCTBackedTextInputViewProtocol.h

@@ -8,7 +8,6 @@
 #import <UIKit/UIKit.h>
 
 @protocol RCTBackedTextInputDelegate;
-@class RCTTextAttributes;
 
 NS_ASSUME_NONNULL_BEGIN
 

package/Libraries/Text/TextInput/Singleline/RCTUITextField.mm

@@ -8,7 +8,6 @@
 #import <React/RCTUITextField.h>
 
 #import <React/RCTBackedTextInputDelegateAdapter.h>
-#import <React/RCTTextAttributes.h>
 #import <React/RCTUtils.h>
 #import <React/UIView+React.h>
 

package/Libraries/Text/TextProps.js

@@ -40,14 +40,19 @@ type TextPointerEventProps = Readonly<{
 
 export type TextPropsIOS = {
   /**
-   * Specifies whether font should be scaled down automatically to fit given style constraints.
+   * Whether fonts should be scaled down to fit style constraints.
    *
-   * See https://reactnative.dev/docs/text#adjustsfontsizetofit
+   * @default `false`
+   * @platform ios
    */
   adjustsFontSizeToFit?: ?boolean,
 
   /**
-   * The Dynamic Type scale ramp to apply to this element on iOS.
+   * The [Dynamic Type](https://developer.apple.com/documentation/uikit/uifont/textstyle)
+   * ramp to apply.
+   *
+   * @default `'body'`
+   * @platform ios
    */
   dynamicTypeRamp?: ?(
     | 'caption2'
@@ -67,14 +72,16 @@ export type TextPropsIOS = {
    * When `true`, no visual change is made when text is pressed down. By
    * default, a gray oval highlights the text on press down.
    *
-   * See https://reactnative.dev/docs/text#supperhighlighting
+   * @default `false`
+   * @platform ios
    */
   suppressHighlighting?: ?boolean,
 
   /**
-   * Set line break strategy on iOS.
+   * Line break strategy on iOS.
    *
-   * See https://reactnative.dev/docs/text.html#linebreakstrategyios
+   * @default `'none'`
+   * @platform ios
    */
   lineBreakStrategyIOS?: ?('none' | 'standard' | 'hangul-word' | 'push-out'),
 };
@@ -83,40 +90,40 @@ export type TextPropsAndroid = {
   /**
    * Specifies the disabled state of the text view for testing purposes.
    *
-   * See https://reactnative.dev/docs/text#disabled
+   * @platform android
    */
   disabled?: ?boolean,
 
   /**
-   * The highlight color of the text.
+   * Highlight color of the text when selected.
    *
-   * See https://reactnative.dev/docs/text#selectioncolor
+   * @platform android
    */
   selectionColor?: ?ColorValue,
 
   /**
-   * Determines the types of data converted to clickable URLs in the text element.
-   * By default no data types are detected.
+   * Types of data converted to clickable URLs in the text element.
+   *
+   * @default `'none'`
+   * @platform android
    */
   dataDetectorType?: ?('phoneNumber' | 'link' | 'email' | 'none' | 'all'),
 
   /**
-   * Set text break strategy on Android API Level 23+
-   * default is `highQuality`.
+   * Text break strategy on Android.
    *
-   * See https://reactnative.dev/docs/text#textbreakstrategy
+   * @default `'highQuality'`
+   * @platform android
    */
   textBreakStrategy?: ?('balanced' | 'highQuality' | 'simple'),
 
-  /**
-   * iOS Only
-   */
   adjustsFontSizeToFit?: ?boolean,
 
   /**
-   * Specifies smallest possible scale a font can reach when adjustsFontSizeToFit is enabled. (values 0.01-1.0).
+   * Smallest possible font scale when `adjustsFontSizeToFit` is enabled
+   * (values 0.01-1.0).
    *
-   * See https://reactnative.dev/docs/text#minimumfontscale
+   * @platform ios
    */
   minimumFontScale?: ?number,
 };
@@ -124,105 +131,70 @@ export type TextPropsAndroid = {
 type TextBaseProps = Readonly<{
   onAccessibilityAction?: ?(event: AccessibilityActionEvent) => unknown,
 
+  /**
+   * Controls whether the `Text` can be the target of touch events.
+   */
+  pointerEvents?: ?('auto' | 'box-none' | 'box-only' | 'none'),
+
   /**
    * Whether fonts should scale to respect Text Size accessibility settings.
-   * The default is `true`.
    *
-   * See https://reactnative.dev/docs/text#allowfontscaling
+   * @default `true`
    */
   allowFontScaling?: ?boolean,
 
   /**
-   * Set hyphenation strategy on Android.
+   * Sets automatic hyphenation frequency.
    *
+   * @default `'none'`
+   * @platform android
    */
   android_hyphenationFrequency?: ?('normal' | 'none' | 'full'),
+
   children?: ?React.Node,
 
   /**
-   * When `numberOfLines` is set, this prop defines how text will be
-   * truncated.
-   *
-   * This can be one of the following values:
-   *
-   * - `head` - The line is displayed so that the end fits in the container and the missing text
-   * at the beginning of the line is indicated by an ellipsis glyph. e.g., "...wxyz"
-   * - `middle` - The line is displayed so that the beginning and end fit in the container and the
-   * missing text in the middle is indicated by an ellipsis glyph. "ab...yz"
-   * - `tail` - The line is displayed so that the beginning fits in the container and the
-   * missing text at the end of the line is indicated by an ellipsis glyph. e.g., "abcd..."
-   * - `clip` - Lines are not drawn past the edge of the text container.
-   *
-   * The default is `tail`.
+   * How text is truncated when `numberOfLines` is set. On Android with
+   * `numberOfLines` greater than 1, only `'tail'` works correctly.
    *
-   * `numberOfLines` must be set in conjunction with this prop.
-   *
-   * > `clip` is working only for iOS
-   *
-   * See https://reactnative.dev/docs/text#ellipsizemode
+   * @default `'tail'`
    */
   ellipsizeMode?: ?('clip' | 'head' | 'middle' | 'tail'),
 
-  /**
-   * Used to reference react managed views from native code.
-   *
-   * See https://reactnative.dev/docs/text#nativeid
-   */
   id?: string,
 
   /**
-   * Specifies largest possible scale a font can reach when `allowFontScaling` is enabled.
-   * Possible values:
-   * `null/undefined` (default): inherit from the parent node or the global default (0)
-   * `0`: no max, ignore parent/global default
-   * `>= 1`: sets the maxFontSizeMultiplier of this node to this value
+   * Largest possible font scale when `allowFontScaling` is enabled.
+   * `null`/`undefined` inherits from the parent node or the global default (0).
+   * `0` means no max (ignores parent/global default). `>= 1` sets the
+   * `maxFontSizeMultiplier` of this node to this value.
    */
   maxFontSizeMultiplier?: ?number,
 
-  /**
-   * Used to locate this view from native code.
-   *
-   * See https://reactnative.dev/docs/text#nativeid
-   */
   nativeID?: ?string,
 
   /**
-   * Used to truncate the text with an ellipsis after computing the text
-   * layout, including line wrapping, such that the total number of lines
-   * does not exceed this number.
+   * Truncate text with an ellipsis after this many lines. `0` means no
+   * restriction.
    *
-   * This prop is commonly used with `ellipsizeMode`.
-   *
-   * See https://reactnative.dev/docs/text#numberoflines
+   * @default `0`
    */
   numberOfLines?: ?number,
 
-  /**
-   * Invoked on mount and layout changes.
-   *
-   * {nativeEvent: { layout: {x, y, width, height}}}.
-   *
-   * See https://reactnative.dev/docs/text#onlayout
-   */
   onLayout?: ?(event: LayoutChangeEvent) => unknown,
 
-  /**
-   * This function is called on long press.
-   * e.g., `onLongPress={this.increaseSize}>`
-   *
-   * See https://reactnative.dev/docs/text#onlongpress
-   */
+  /** Called on long press. */
   onLongPress?: ?(event: GestureResponderEvent) => unknown,
 
-  /**
-   * This function is called on press.
-   * Text intrinsically supports press handling with a default highlight state (which can be disabled with suppressHighlighting).
-   *
-   * See https://reactnative.dev/docs/text#onpress
-   */
+  /** Called on press, triggered after `onPressOut`. */
   onPress?: ?(event: GestureResponderEvent) => unknown,
+
+  /** Called immediately when a touch is engaged. */
   onPressIn?: ?(event: GestureResponderEvent) => unknown,
+
+  /** Called when a touch is released. */
   onPressOut?: ?(event: GestureResponderEvent) => unknown,
+
   onResponderGrant?: ?(event: GestureResponderEvent) => void,
   onResponderMove?: ?(event: GestureResponderEvent) => void,
   onResponderRelease?: ?(event: GestureResponderEvent) => void,
@@ -230,13 +202,13 @@ type TextBaseProps = Readonly<{
   onResponderTerminationRequest?: ?() => boolean,
   onStartShouldSetResponder?: ?() => boolean,
   onMoveShouldSetResponder?: ?() => boolean,
+
+  /** Invoked on text layout change. */
   onTextLayout?: ?(event: TextLayoutEvent) => unknown,
 
   /**
    * Defines how far your touch may move off of the button, before
    * deactivating the button.
-   *
-   * See https://reactnative.dev/docs/text#pressretentionoffset
    */
   pressRetentionOffset?: ?PressRetentionOffset,
 
@@ -246,27 +218,21 @@ type TextBaseProps = Readonly<{
   role?: ?Role,
 
   /**
-   * Lets the user select text.
+   * Lets the user select text for native copy and paste.
    *
-   * See https://reactnative.dev/docs/text#selectable
+   * @default `false`
    */
   selectable?: ?boolean,
 
-  /**
-   * @see https://reactnative.dev/docs/text#style
-   */
   style?: ?TextStyleProp,
 
-  /**
-   * Used to locate this view in end-to-end tests.
-   *
-   * See https://reactnative.dev/docs/text#testid
-   */
   testID?: ?string,
 }>;
 
 /**
  * @see https://reactnative.dev/docs/text#reference
+ *
+ * @build-types emit-as-interface Uniwind compatibility
  */
 export type TextProps = Readonly<{
   ...TextPointerEventProps,

package/Libraries/Text/requireNativeTextEffect.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-local
+ * @format
+ */
+
+import Text from './Text';
+import NativeTextEffect from './TextEffectNativeComponent';
+import * as React from 'react';
+
+export default function requireNativeTextEffect<P>(
+  name: string,
+): React.ComponentType<{...P, children: React.Node}> {
+  component TextEffect(...props: {...P, children: React.Node}) {
+    const {children, ...effectProps} = props;
+    return (
+      <NativeTextEffect effectName={name} effectProps={effectProps}>
+        <Text>{children}</Text>
+      </NativeTextEffect>
+    );
+  }
+  TextEffect.displayName = `TextEffect(${name})`;
+  return TextEffect;
+}

package/Libraries/TurboModule/RCTExport.js

@@ -30,7 +30,7 @@
 
 // eslint-disable-next-line no-unused-vars
 export interface DEPRECATED_RCTExport<T extends void = void> {
-  +getConstants?: () => {...};
+  readonly getConstants?: () => {...};
 }
 
 export interface TurboModule extends DEPRECATED_RCTExport<void> {}

package/Libraries/Types/CoreEventTypes.d.ts

@@ -270,6 +270,14 @@ export interface PointerEvents {
   onPointerDownCapture?: ((event: PointerEvent) => void) | undefined;
   onPointerUp?: ((event: PointerEvent) => void) | undefined;
   onPointerUpCapture?: ((event: PointerEvent) => void) | undefined;
+  onPointerOver?: ((event: PointerEvent) => void) | undefined;
+  onPointerOverCapture?: ((event: PointerEvent) => void) | undefined;
+  onPointerOut?: ((event: PointerEvent) => void) | undefined;
+  onPointerOutCapture?: ((event: PointerEvent) => void) | undefined;
+  onGotPointerCapture?: ((event: PointerEvent) => void) | undefined;
+  onGotPointerCaptureCapture?: ((event: PointerEvent) => void) | undefined;
+  onLostPointerCapture?: ((event: PointerEvent) => void) | undefined;
+  onLostPointerCaptureCapture?: ((event: PointerEvent) => void) | undefined;
 }
 
 export interface PressEvents {

package/Libraries/Types/CoreEventTypes.js

@@ -10,7 +10,7 @@
 
 import type {HostInstance} from '../../src/private/types/HostInstance';
 
-export type NativeSyntheticEvent<+T> = Readonly<{
+export type NativeSyntheticEvent<out T> = Readonly<{
   bubbles: ?boolean,
   cancelable: ?boolean,
   currentTarget: number | HostInstance,
@@ -76,6 +76,9 @@ export type LayoutChangeEvent = NativeSyntheticEvent<
   }>,
 >;
 
+/**
+ * @deprecated Use `TextLayoutEvent` instead.
+ */
 type TextLayoutEventData = Readonly<{
   lines: Array<TextLayoutLine>,
 }>;
@@ -102,7 +105,7 @@ export interface NativeUIEvent {
   /**
    * Returns a long with details about the event, depending on the event type.
    */
-  +detail: number;
+  readonly detail: number;
 }
 
 /**
@@ -112,72 +115,72 @@ export interface NativeMouseEvent extends NativeUIEvent {
   /**
    * The X coordinate of the mouse pointer in global (screen) coordinates.
    */
-  +screenX: number;
+  readonly screenX: number;
   /**
    * The Y coordinate of the mouse pointer in global (screen) coordinates.
    */
-  +screenY: number;
+  readonly screenY: number;
   /**
    * The X coordinate of the mouse pointer relative to the whole document.
    */
-  +pageX: number;
+  readonly pageX: number;
   /**
    * The Y coordinate of the mouse pointer relative to the whole document.
    */
-  +pageY: number;
+  readonly pageY: number;
   /**
    * The X coordinate of the mouse pointer in local (DOM content) coordinates.
    */
-  +clientX: number;
+  readonly clientX: number;
   /**
    * The Y coordinate of the mouse pointer in local (DOM content) coordinates.
    */
-  +clientY: number;
+  readonly clientY: number;
   /**
    * Alias for NativeMouseEvent.clientX
    */
-  +x: number;
+  readonly x: number;
   /**
    * Alias for NativeMouseEvent.clientY
    */
-  +y: number;
+  readonly y: number;
   /**
    * Returns true if the control key was down when the mouse event was fired.
    */
-  +ctrlKey: boolean;
+  readonly ctrlKey: boolean;
   /**
    * Returns true if the shift key was down when the mouse event was fired.
    */
-  +shiftKey: boolean;
+  readonly shiftKey: boolean;
   /**
    * Returns true if the alt key was down when the mouse event was fired.
    */
-  +altKey: boolean;
+  readonly altKey: boolean;
   /**
    * Returns true if the meta key was down when the mouse event was fired.
    */
-  +metaKey: boolean;
+  readonly metaKey: boolean;
   /**
    * The button number that was pressed (if applicable) when the mouse event was fired.
    */
-  +button: number;
+  readonly button: number;
   /**
    * The buttons being depressed (if any) when the mouse event was fired.
    */
-  +buttons: number;
+  readonly buttons: number;
   /**
    * The secondary target for the event, if there is one.
    */
-  +relatedTarget: null | number | HostInstance;
+  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
    */
-  +offsetX: number;
+  readonly offsetX: number;
   /**
    * The Y coordinate of the mouse pointer between that event and the padding edge of the target node
    */
-  +offsetY: number;
+  readonly offsetY: number;
 }
 
 /**
@@ -187,48 +190,48 @@ export interface NativePointerEvent extends NativeMouseEvent {
   /**
    * A unique identifier for the pointer causing the event.
    */
-  +pointerId: number;
+  readonly pointerId: number;
   /**
    * The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer
    */
-  +width: number;
+  readonly width: number;
   /**
    * The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer.
    */
-  +height: number;
+  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.
    */
-  +pressure: number;
+  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.
    */
-  +tangentialPressure: number;
+  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.
    */
-  +tiltX: number;
+  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.
    */
-  +tiltY: number;
+  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.
    */
-  +twist: number;
+  readonly twist: number;
   /**
    * Indicates the device type that caused the event (mouse, pen, touch, etc.)
    */
-  +pointerType: string;
+  readonly pointerType: string;
   /**
    * Indicates if the pointer represents the primary pointer of this pointer type.
    */
-  +isPrimary: boolean;
+  readonly isPrimary: boolean;
 }
 
 export type PointerEvent = NativeSyntheticEvent<NativePointerEvent>;