@office-iss/react-native-win32 0.73.1 → 0.74.0-preview.1

package/{src → src-win}/Libraries/Components/View/ViewAccessibility.d.ts

@@ -61,13 +61,6 @@ export interface AccessibilityProps
   'aria-required'?: boolean | undefined; // Win32
   'aria-selected'?: boolean | undefined;
 
-  /**
-   * Represents the nativeID of the associated label text. When the assistive technology focuses on the component with this props, the text is read aloud.
-   *
-   * @platform android
-   */
-  'aria-labelledby'?: string | undefined;
-
   /**
    * An accessibility hint helps users understand what will happen when they perform an action on the accessibility element when that result is not obvious from the accessibility label.
    */
@@ -102,7 +95,6 @@ export interface AccessibilityProps
    */
   'aria-hidden'?: boolean | undefined;
 
-  'aria-live'?: ('polite' | 'assertive' | 'off') | undefined;
   'aria-modal'?: boolean | undefined;
 
   /**
@@ -274,13 +266,41 @@ export type AccessibilityRole =
 
 export interface AccessibilityPropsAndroid {
   /**
-   * Indicates to accessibility services whether the user should be notified when this view changes.
-   * Works for Android API >= 19 only.
-   * See http://developer.android.com/reference/android/view/View.html#attr_android:accessibilityLiveRegion for references.
+   * Identifies the element that labels the element it is applied to. When the assistive technology focuses on the component with this props,
+   * the text is read aloud. The value should should match the nativeID of the related element.
+   *
+   * @platform android
+   */
+  accessibilityLabelledBy?: string | string[] | undefined;
+
+  /**
+   * Identifies the element that labels the element it is applied to. When the assistive technology focuses on the component with this props,
+   * the text is read aloud. The value should should match the nativeID of the related element.
+   *
    * @platform android
    */
+  'aria-labelledby'?: string | undefined;
+
+  /**
+   * Indicates to accessibility services whether the user should be notified
+   * when this view changes. Works for Android API >= 19 only.
+   *
+   * @platform android
+   *
+   * See https://reactnative.dev/docs/view#accessibilityliveregion
+   */
   accessibilityLiveRegion?: 'none' | 'polite' | 'assertive' | undefined;
 
+  /**
+   * Indicates to accessibility services whether the user should be notified
+   * when this view changes. Works for Android API >= 19 only.
+   *
+   * @platform android
+   *
+   * See https://reactnative.dev/docs/view#accessibilityliveregion
+   */
+  'aria-live'?: ('polite' | 'assertive' | 'off') | undefined;
+
   /**
    * Controls how view is important for accessibility which is if it fires accessibility events
    * and if it is reported to accessibility services that query the screen.
@@ -291,6 +311,8 @@ export interface AccessibilityPropsAndroid {
    *      'yes' - The view is important for accessibility.
    *      'no' - The view is not important for accessibility.
    *      'no-hide-descendants' - The view is not important for accessibility, nor are any of its descendant views.
+   *
+   * @platform android
    */
   importantForAccessibility?:
     | 'auto'
@@ -298,12 +320,6 @@ export interface AccessibilityPropsAndroid {
     | 'no'
     | 'no-hide-descendants'
     | undefined;
-
-  /**
-   * A reference to another element `nativeID` used to build complex forms. The value of `accessibilityLabelledBy` should match the `nativeID` of the related element.
-   * @platform android
-   */
-  accessibilityLabelledBy?: string | string[] | undefined;
 }
 
 export interface AccessibilityPropsIOS {

package/{src → src-win}/Libraries/Components/View/ViewPropTypes.d.ts

@@ -137,22 +137,6 @@ export interface ViewPropsAndroid {
    */
   collapsable?: boolean | undefined;
 
-  /**
-   * Whether this view needs to rendered offscreen and composited with an alpha in order to preserve 100% correct colors and blending behavior.
-   * The default (false) falls back to drawing the component and its children
-   * with an alpha applied to the paint used to draw each element instead of rendering the full component offscreen and compositing it back with an alpha value.
-   * This default may be noticeable and undesired in the case where the View you are setting an opacity on
-   * has multiple overlapping elements (e.g. multiple overlapping Views, or text and a background).
-   *
-   * Rendering offscreen to preserve correct alpha behavior is extremely expensive
-   * and hard to debug for non-native developers, which is why it is not turned on by default.
-   * If you do need to enable this property for an animation,
-   * consider combining it with renderToHardwareTextureAndroid if the view contents are static (i.e. it doesn't need to be redrawn each frame).
-   * If that property is enabled, this View will be rendered off-screen once,
-   * saved in a hardware texture, and then composited onto the screen with an alpha each frame without having to switch rendering targets on the GPU.
-   */
-  needsOffscreenAlphaCompositing?: boolean | undefined;
-
   /**
    * Whether this view should render itself (and all of its children) into a single hardware texture on the GPU.
    *
@@ -166,6 +150,17 @@ export interface ViewPropsAndroid {
    * Whether this `View` should be focusable with a non-touch input device, eg. receive focus with a hardware keyboard.
    */
   focusable?: boolean | undefined;
+
+  /**
+   * Indicates whether this `View` should be focusable with a non-touch input device, eg. receive focus with a hardware keyboard.
+   * See https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex
+   * for more details.
+   *
+   * Supports the following values:
+   * -  0 (View is focusable)
+   * - -1 (View is not focusable)
+   */
+  // tabIndex?: 0 | -1 | undefined; [Windows fix to get react-native-picker working #12548]
 }
 
 // [Win32
@@ -316,13 +311,29 @@ export interface ViewProps
    * the Z-index of sibling views always takes precedence if a touch
    * hits two overlapping views.
    */
-  hitSlop?: Insets | undefined;
+  hitSlop?: null | Insets | number | undefined;
 
   /**
    * Used to reference react managed views from native code.
    */
   id?: string | undefined;
 
+  /**
+   * Whether this view needs to rendered offscreen and composited with an alpha in order to preserve 100% correct colors and blending behavior.
+   * The default (false) falls back to drawing the component and its children
+   * with an alpha applied to the paint used to draw each element instead of rendering the full component offscreen and compositing it back with an alpha value.
+   * This default may be noticeable and undesired in the case where the View you are setting an opacity on
+   * has multiple overlapping elements (e.g. multiple overlapping Views, or text and a background).
+   *
+   * Rendering offscreen to preserve correct alpha behavior is extremely expensive
+   * and hard to debug for non-native developers, which is why it is not turned on by default.
+   * If you do need to enable this property for an animation,
+   * consider combining it with renderToHardwareTextureAndroid if the view contents are static (i.e. it doesn't need to be redrawn each frame).
+   * If that property is enabled, this View will be rendered off-screen once,
+   * saved in a hardware texture, and then composited onto the screen with an alpha each frame without having to switch rendering targets on the GPU.
+   */
+  needsOffscreenAlphaCompositing?: boolean | undefined;
+
   /**
    * Invoked on mount and layout changes with
    *

package/{src → src-win}/Libraries/StyleSheet/PlatformColorValueTypesWin32.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) Facebook, Inc. and its affiliates.
+ * 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.

package/src-win/Libraries/Text/Text.d.ts

@@ -0,0 +1,304 @@
+/**
+ * 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 {Constructor} from '../../types/private/Utilities';
+import {AccessibilityProps} from '../Components/View/ViewAccessibility';
+import {NativeMethods} from '../../types/public/ReactNativeTypes';
+import {ColorValue, StyleProp} from '../StyleSheet/StyleSheet';
+import {TextStyle} from '../StyleSheet/StyleSheetTypes';
+import {
+  GestureResponderEvent,
+  LayoutChangeEvent,
+  NativeSyntheticEvent,
+  TextLayoutEventData,
+} from '../Types/CoreEventTypes';
+import type {
+  IKeyboardEvent,
+  IHandledKeyboardEvent,
+} from '../View/ViewPropTypes'; // Win32
+
+export interface TextPropsIOS {
+  /**
+   * Specifies whether font should be scaled down automatically to fit given style constraints.
+   */
+  adjustsFontSizeToFit?: boolean | undefined;
+
+  /**
+   * The Dynamic Type scale ramp to apply to this element on iOS.
+   */
+  dynamicTypeRamp?:
+    | 'caption2'
+    | 'caption1'
+    | 'footnote'
+    | 'subheadline'
+    | 'callout'
+    | 'body'
+    | 'headline'
+    | 'title3'
+    | 'title2'
+    | 'title1'
+    | 'largeTitle'
+    | undefined;
+
+  /**
+   * When `true`, no visual change is made when text is pressed down. By
+   * default, a gray oval highlights the text on press down.
+   */
+  suppressHighlighting?: boolean | undefined;
+
+  /**
+   * Set line break strategy on iOS.
+   */
+  lineBreakStrategyIOS?:
+    | 'none'
+    | 'standard'
+    | 'hangul-word'
+    | 'push-out'
+    | undefined;
+}
+
+export interface TextPropsAndroid {
+  /**
+   * Specifies the disabled state of the text view for testing purposes.
+   */
+  disabled?: boolean | undefined;
+
+  /**
+   * Lets the user select text, to use the native copy and paste functionality.
+   */
+  selectable?: boolean | undefined;
+
+  /**
+   * The highlight color of the text.
+   */
+  selectionColor?: ColorValue | undefined;
+
+  /**
+   * Set text break strategy on Android API Level 23+
+   * default is `highQuality`.
+   */
+  textBreakStrategy?: 'simple' | 'highQuality' | 'balanced' | undefined;
+
+  /**
+   * Determines the types of data converted to clickable URLs in the text element.
+   * By default no data types are detected.
+   */
+  dataDetectorType?:
+    | null
+    | 'phoneNumber'
+    | 'link'
+    | 'email'
+    | 'none'
+    | 'all'
+    | undefined;
+
+  /**
+   * Hyphenation strategy
+   */
+  android_hyphenationFrequency?: 'normal' | 'none' | 'full' | undefined;
+}
+
+/**
+ * Role-based text style names.
+ */
+export type TextWin32TextStyle =
+  | 'None'
+  | 'SmallStandard'
+  | 'SmallSecondary'
+  | 'MediumStandard'
+  | 'MediumSecondary'
+  | 'MediumApp'
+  | 'MediumBold'
+  | 'MediumBoldApp'
+  | 'LargeStandard'
+  | 'LargePlusStandard'
+  | 'ExtraLargeStandard'
+  | 'HugeStandard';
+
+export interface TextPropsWin32 {
+  onKeyDown?: (args: IKeyboardEvent) => void;
+  onKeyDownCapture?: (args: IKeyboardEvent) => void;
+  onKeyUp?: (args: IKeyboardEvent) => void;
+  onKeyUpCapture?: (args: IKeyboardEvent) => void;
+
+  keyDownEvents?: IHandledKeyboardEvent[];
+  keyUpEvents?: IHandledKeyboardEvent[];
+
+  /** Enables a focusable label with copyability but without character selectability (property:selectable) */
+  focusable?: boolean;
+
+  /**
+   * The onBlur event occurs when an element loses focus.  The opposite of onBlur is onFocus.  Note that in React
+   * Native, unlike in the web, the onBlur event bubbles (similar to onFocusOut in the web).
+   *
+   * `ev.target === ev.currentTarget` when the focus is being lost from this component.
+   * `ev.target !== ev.currentTarget` when the focus is being lost from a descendant.
+   */
+  onBlur?: (ev: NativeSyntheticEvent<{}>) => void;
+  /**
+   * The onBlur event occurs when an element loses focus.  The opposite of onBlur is onFocus.  Note that in React
+   * Native, unlike in the web, the onBlur event bubbles (similar to onFocusOut in the web).
+   *
+   * `ev.target === ev.currentTarget` when the focus is being lost from this component.
+   * `ev.target !== ev.currentTarget` when the focus is being lost from a descendant.
+   */
+  onBlurCapture?: (ev: NativeSyntheticEvent<{}>) => void;
+  /**
+   * The onFocus event occurs when an element gets focus. The opposite of onFocus is onBlur.  Note that in React
+   * Native, unlike in the web, the onFocus event bubbles (similar to onFocusIn in the web).
+   *
+   * `ev.target === ev.currentTarget` when the focus is being lost from this component.
+   * `ev.target !== ev.currentTarget` when the focus is being lost from a descendant.
+   */
+  onFocus?: (ev: NativeSyntheticEvent<{}>) => void;
+  /**
+   * The onFocus event occurs when an element gets focus. The opposite of onFocus is onBlur.  Note that in React
+   * Native, unlike in the web, the onFocus event bubbles (similar to onFocusIn in the web).
+   *
+   * `ev.target === ev.currentTarget` when the focus is being lost from this component.
+   * `ev.target !== ev.currentTarget` when the focus is being lost from a descendant.
+   */
+  onFocusCapture?: (ev: NativeSyntheticEvent<{}>) => void;
+
+  /**
+   * Role-based styling of the text control. The styles applied include
+   * font face, size, weight and color. These styles take precedence over
+   * the `style` property.
+   *
+   * @remarks
+   * The default value is `MediumStandard`.
+   *
+   * When set to `None`, role-based styling is disabled.
+   *
+   * @deprecated Use `style` instead.
+   */
+  textStyle?: TextWin32TextStyle;
+
+  /** Tooltip displayed on mouse hover of this element */
+  tooltip?: string;
+}
+
+// https://reactnative.dev/docs/text#props
+export interface TextProps
+  extends TextPropsIOS,
+    TextPropsAndroid,
+    TextPropsWin32, // Win32
+    AccessibilityProps {
+  /**
+   * Specifies whether fonts should scale to respect Text Size accessibility settings.
+   * The default is `true`.
+   */
+  allowFontScaling?: boolean | undefined;
+
+  children?: React.ReactNode | undefined;
+
+  /**
+   * 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`.
+   *
+   * `numberOfLines` must be set in conjunction with this prop.
+   *
+   * > `clip` is working only for iOS
+   */
+  ellipsizeMode?: 'head' | 'middle' | 'tail' | 'clip' | undefined;
+
+  /**
+   * Used to reference react managed views from native code.
+   */
+  id?: string | undefined;
+
+  /**
+   * Line Break mode. Works only with numberOfLines.
+   * clip is working only for iOS
+   */
+  lineBreakMode?: 'head' | 'middle' | 'tail' | 'clip' | undefined;
+
+  /**
+   * 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.
+   *
+   * This prop is commonly used with `ellipsizeMode`.
+   */
+  numberOfLines?: number | undefined;
+
+  /**
+   * Invoked on mount and layout changes with
+   *
+   * {nativeEvent: { layout: {x, y, width, height}}}.
+   */
+  onLayout?: ((event: LayoutChangeEvent) => void) | undefined;
+
+  /**
+   * Invoked on Text layout
+   */
+  onTextLayout?:
+    | ((event: NativeSyntheticEvent<TextLayoutEventData>) => void)
+    | undefined;
+
+  /**
+   * This function is called on press.
+   * Text intrinsically supports press handling with a default highlight state (which can be disabled with suppressHighlighting).
+   */
+  onPress?: ((event: GestureResponderEvent) => void) | undefined;
+
+  onPressIn?: ((event: GestureResponderEvent) => void) | undefined;
+  onPressOut?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   * This function is called on long press.
+   * e.g., `onLongPress={this.increaseSize}>``
+   */
+  onLongPress?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   * @see https://reactnative.dev/docs/text#style
+   */
+  style?: StyleProp<TextStyle> | undefined;
+
+  /**
+   * Used to locate this view in end-to-end tests.
+   */
+  testID?: string | undefined;
+
+  /**
+   * Used to reference react managed views from native code.
+   */
+  nativeID?: string | undefined;
+
+  /**
+   * 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
+   */
+  maxFontSizeMultiplier?: number | null | undefined;
+
+  /**
+   * Specifies smallest possible scale a font can reach when adjustsFontSizeToFit is enabled. (values 0.01-1.0).
+   */
+  minimumFontScale?: number | undefined;
+}
+
+/**
+ * A React component for displaying text which supports nesting, styling, and touch handling.
+ */
+declare class TextComponent extends React.Component<TextProps> {}
+declare const TextBase: Constructor<NativeMethods> & typeof TextComponent;
+export class Text extends TextBase {}

package/{src → src-win}/Libraries/platform-types.d.ts

@@ -11,10 +11,9 @@ export { AccessibilityPropsWin32 } from '@office-iss/react-native-win32/Librarie
 export type IViewWin32Props = IViewWin32PropsOnly & AccessibilityPropsWin32;
 export {ViewWin32} from './Components/View/ViewWin32';
 export {IKeyboardEvent, IHandledKeyboardEvent, EventPhase} from './Components/View/ViewPropTypes';
-import {ITextWin32Props as ITextWin32PropsOnly} from './Components/Text/TextWin32.Props';
+import {TextPropsWin32 as ITextWin32PropsOnly} from './Components/Text/Text';
 export type ITextWin32Props = ITextWin32PropsOnly & AccessibilityPropsWin32;
-export {TextWin32TextStyle } from './Components/Text/TextWin32.Props';
-export {TextWin32} from './Components/Text/TextWin32';
+export {TextWin32TextStyle, Text as TextWin32 } from './Components/Text/Text';
 export {IButtonWin32Props, IButtonWin32Style} from './Components/Button/ButtonWin32.Props';
 export {ButtonWin32} from './Components/Button/ButtonWin32';
 export {GradientColorStop, GradientColorValueWin32, ColorGradientWin32} from './StyleSheet/PlatformColorValueTypesWin32';

package/types/modules/globals.d.ts

@@ -460,6 +460,7 @@ interface WebSocket extends EventTarget {
   readonly readyState: number;
   send(data: string | ArrayBuffer | ArrayBufferView | Blob): void;
   close(code?: number, reason?: string): void;
+  ping(): void;
   onopen: (() => void) | null;
   onmessage: ((event: WebSocketMessageEvent) => void) | null;
   onerror: ((event: WebSocketErrorEvent) => void) | null;