@office-iss/react-native-win32 0.0.0-canary.31 → 0.0.0-canary.310

package/types/modules/BatchedBridge.d.ts

@@ -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
+ */
+
+interface SpyData {
+  type: number;
+  module?: string | undefined;
+  method: string | number;
+  args: any[];
+}
+
+declare class MessageQueue {
+  static spy(spyOrToggle: boolean | ((data: SpyData) => void)): void;
+
+  getCallableModule(name: string): Object;
+  registerCallableModule(name: string, module: Object): void;
+  registerLazyCallableModule(name: string, factory: () => Object): void;
+}
+
+declare module 'react-native/Libraries/BatchedBridge/BatchedBridge' {
+  const BatchedBridge: MessageQueue;
+  export default BatchedBridge;
+}
+
+declare module 'react-native/Libraries/BatchedBridge/MessageQueue' {
+  export default MessageQueue;
+}

package/types/modules/Codegen.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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
+ */
+
+declare module 'react-native/Libraries/Utilities/codegenNativeCommands' {
+  export interface Options<T extends string> {
+    readonly supportedCommands: ReadonlyArray<T>;
+  }
+
+  function codegenNativeCommands<T extends object>(
+    options: Options<keyof T extends string ? keyof T : never>,
+  ): T;
+
+  export default codegenNativeCommands;
+}
+
+declare module 'react-native/Libraries/Utilities/codegenNativeComponent' {
+  import type {HostComponent} from 'react-native';
+
+  export interface Options {
+    readonly interfaceOnly?: boolean | undefined;
+    readonly paperComponentName?: string | undefined;
+    readonly paperComponentNameDeprecated?: string | undefined;
+    readonly excludedPlatforms?: ReadonlyArray<'iOS' | 'android'> | undefined;
+  }
+
+  export type NativeComponentType<T> = HostComponent<T>;
+
+  function codegenNativeComponent<Props extends object>(
+    componentName: string,
+    options?: Options,
+  ): NativeComponentType<Props>;
+
+  export default codegenNativeComponent;
+}
+
+declare module 'react-native/Libraries/Types/CodegenTypes' {
+  import type {NativeSyntheticEvent} from 'react-native';
+  import type {EventSubscription} from 'react-native/Libraries/vendor/emitter/EventEmitter';
+
+  // Event types
+  // We're not using the PaperName, it is only used to codegen view config settings
+
+  export type BubblingEventHandler<
+    T,
+    PaperName extends string | never = never,
+  > = (event: NativeSyntheticEvent<T>) => void | Promise<void>;
+  export type DirectEventHandler<
+    T,
+    PaperName extends string | never = never,
+  > = (event: NativeSyntheticEvent<T>) => void | Promise<void>;
+
+  // Prop types
+  export type Double = number;
+  export type Float = number;
+  export type Int32 = number;
+  export type UnsafeObject = object;
+  export type UnsafeMixed = unknown;
+
+  type DefaultTypes = number | boolean | string | ReadonlyArray<string>;
+  // Default handling, ignore the unused value
+  // we're only using it for type checking
+  //
+  // TODO: (rickhanlonii) T44881457 If a default is provided, it should always be optional
+  //  but that is currently not supported in the codegen since we require a default
+
+  export type WithDefault<
+    Type extends DefaultTypes,
+    Value extends Type | string | undefined | null,
+  > = Type | undefined | null;
+
+  export type EventEmitter<T> = (
+    handler: (arg: T) => void | Promise<void>,
+  ) => EventSubscription;
+}

package/types/modules/Devtools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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
+ */
+
+declare module 'react-native/Libraries/Core/Devtools/parseErrorStack' {
+  export type StackFrame = {
+    column: number | null | undefined;
+    file: string | null | undefined;
+    lineNumber: number | null | undefined;
+    methodName: string;
+  };
+
+  export default function parseErrorStack(errorStack?: string): StackFrame[];
+}
+
+declare module 'react-native/Libraries/Core/Devtools/symbolicateStackTrace' {
+  import {StackFrame} from 'react-native/Libraries/Core/Devtools/parseErrorStack';
+
+  export type CodeFrame = Readonly<{
+    content: string;
+    location:
+      | {
+          row: number;
+          column: number;
+          [key: string]: any;
+        }
+      | null
+      | undefined;
+    fileName: string;
+  }>;
+
+  export type SymbolicatedStackTrace = Readonly<{
+    stack: ReadonlyArray<StackFrame>;
+    codeFrame: CodeFrame | null | undefined;
+  }>;
+
+  export default function symbolicateStackTrace(
+    stack: ReadonlyArray<StackFrame>,
+    extraData?: any,
+  ): Promise<SymbolicatedStackTrace>;
+}

package/types/private/TimerMixin.d.ts

@@ -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.
+ *
+ * @format
+ */
+
+export interface TimerMixin {
+  setTimeout: typeof setTimeout;
+  clearTimeout: typeof clearTimeout;
+  setInterval: typeof setInterval;
+  clearInterval: typeof clearInterval;
+  setImmediate: typeof setImmediate;
+  clearImmediate: typeof clearImmediate;
+  requestAnimationFrame: typeof requestAnimationFrame;
+  cancelAnimationFrame: typeof cancelAnimationFrame;
+}

package/types/private/Utilities.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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
+ */
+
+export type Constructor<T> = new (...args: any[]) => T;

package/types/public/DeprecatedPropertiesAlias.d.ts

@@ -0,0 +1,185 @@
+/**
+ * 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 {
+  TextProps,
+  TextPropsIOS,
+  TextPropsAndroid,
+  AccessibilityProps,
+  AccessibilityPropsIOS,
+  AccessibilityPropsAndroid,
+  TextInputProps,
+  TextInputIOSProps,
+  TextInputAndroidProps,
+  ViewProps,
+  ViewPropsIOS,
+  ViewPropsAndroid,
+  ScrollViewProps,
+  ScrollViewPropsIOS,
+  ScrollViewPropsAndroid,
+  InputAccessoryViewProps,
+  ActivityIndicatorProps,
+  ActivityIndicatorIOSProps,
+  DrawerLayoutAndroidProps,
+  ProgressBarAndroidProps,
+  RefreshControlProps,
+  RefreshControlPropsIOS,
+  RefreshControlPropsAndroid,
+  ImageSourcePropType,
+  ImageProps,
+  ImagePropsIOS,
+  ImagePropsAndroid,
+  ImageBackgroundProps,
+  FlatListProps,
+  VirtualizedListProps,
+  SectionListProps,
+  ModalProps,
+  TouchableWithoutFeedbackProps,
+  TouchableHighlightProps,
+  TouchableOpacityProps,
+  TouchableNativeFeedbackProps,
+  ButtonProps,
+  StatusBarProps,
+  StatusBarPropsIOS,
+  StatusBarPropsAndroid,
+  SwitchProps,
+  SwitchPropsIOS,
+} from 'react-native';
+
+/*
+ * Previously, props interfaces where named *Properties
+ * They have been renamed to *Props to match React Native documentation
+ * The following lines ensure compatibility with *Properties and should be removed in the future
+ */
+
+/** @deprecated Use TextProps */
+export type TextProperties = TextProps;
+
+/** @deprecated Use TextPropsIOS */
+export type TextPropertiesIOS = TextPropsIOS;
+
+/** @deprecated Use TextPropsAndroid */
+export type TextPropertiesAndroid = TextPropsAndroid;
+
+/** @deprecated Use AccessibilityProps */
+export type AccessibilityProperties = AccessibilityProps;
+
+/** @deprecated Use AccessibilityPropsIOS */
+export type AccessibilityPropertiesIOS = AccessibilityPropsIOS;
+
+/** @deprecated Use AccessibilityPropsAndroid */
+export type AccessibilityPropertiesAndroid = AccessibilityPropsAndroid;
+
+/** @deprecated Use TextInputProps */
+export type TextInputProperties = TextInputProps;
+
+/** @deprecated Use TextInputIOSProps */
+export type TextInputIOSProperties = TextInputIOSProps;
+
+/** @deprecated Use TextInputAndroidProps */
+export type TextInputAndroidProperties = TextInputAndroidProps;
+
+/** @deprecated Use ViewProps */
+export type ViewProperties = ViewProps;
+
+/** @deprecated Use ViewPropsIOS */
+export type ViewPropertiesIOS = ViewPropsIOS;
+
+/** @deprecated Use ViewPropsAndroid */
+export type ViewPropertiesAndroid = ViewPropsAndroid;
+
+/** @deprecated Use ScrollViewProps */
+export type ScrollViewProperties = ScrollViewProps;
+
+/** @deprecated Use ScrollViewPropsIOS */
+export type ScrollViewPropertiesIOS = ScrollViewPropsIOS;
+
+/** @deprecated Use ScrollViewPropsAndroid */
+export type ScrollViewPropertiesAndroid = ScrollViewPropsAndroid;
+
+/** @deprecated Use InputAccessoryViewProps */
+export type InputAccessoryViewProperties = InputAccessoryViewProps;
+
+/** @deprecated Use ActivityIndicatorProps */
+export type ActivityIndicatorProperties = ActivityIndicatorProps;
+
+/** @deprecated Use ActivityIndicatorIOSProps */
+export type ActivityIndicatorIOSProperties = ActivityIndicatorIOSProps;
+
+/** @deprecated Use DrawerLayoutAndroidProps */
+export type DrawerLayoutAndroidProperties = DrawerLayoutAndroidProps;
+
+/** @deprecated Use ProgressBarAndroidProps */
+export type ProgressBarAndroidProperties = ProgressBarAndroidProps;
+
+/** @deprecated Use RefreshControlProps */
+export type RefreshControlProperties = RefreshControlProps;
+
+/** @deprecated Use RefreshControlPropsIOS */
+export type RefreshControlPropertiesIOS = RefreshControlPropsIOS;
+
+/** @deprecated Use RefreshControlPropsAndroid */
+export type RefreshControlPropertiesAndroid = RefreshControlPropsAndroid;
+
+/** @deprecated Use ImageSourcePropType */
+export type ImagePropertiesSourceOptions = ImageSourcePropType;
+
+/** @deprecated Use ImageProps */
+export type ImageProperties = ImageProps;
+
+/** @deprecated Use ImagePropsIOS */
+export type ImagePropertiesIOS = ImagePropsIOS;
+
+/** @deprecated Use ImagePropsAndroid */
+export type ImagePropertiesAndroid = ImagePropsAndroid;
+
+/** @deprecated Use ImageBackgroundProps */
+export type ImageBackgroundProperties = ImageBackgroundProps;
+
+/** @deprecated Use FlatListProps */
+export type FlatListProperties<ItemT> = FlatListProps<ItemT>;
+
+/** @deprecated Use VirtualizedListProps */
+export type VirtualizedListProperties<ItemT> = VirtualizedListProps<ItemT>;
+
+/** @deprecated Use SectionListProps */
+export type SectionListProperties<ItemT> = SectionListProps<ItemT>;
+
+/** @deprecated Use ModalProps */
+export type ModalProperties = ModalProps;
+
+/** @deprecated Use TouchableWithoutFeedbackProps */
+export type TouchableWithoutFeedbackProperties = TouchableWithoutFeedbackProps;
+
+/** @deprecated Use TouchableHighlightProps */
+export type TouchableHighlightProperties = TouchableHighlightProps;
+
+/** @deprecated Use TouchableOpacityProps */
+export type TouchableOpacityProperties = TouchableOpacityProps;
+
+/** @deprecated Use TouchableNativeFeedbackProps */
+export type TouchableNativeFeedbackProperties = TouchableNativeFeedbackProps;
+
+/** @deprecated Use ButtonProps */
+export type ButtonProperties = ButtonProps;
+
+/** @deprecated Use StatusBarProps */
+export type StatusBarProperties = StatusBarProps;
+
+/** @deprecated Use StatusBarPropsIOS */
+export type StatusBarPropertiesIOS = StatusBarPropsIOS;
+
+/** @deprecated Use StatusBarPropsAndroid */
+export type StatusBarPropertiesAndroid = StatusBarPropsAndroid;
+
+/** @deprecated Use SwitchProps */
+export type SwitchProperties = SwitchProps;
+
+/** @deprecated Use SwitchPropsIOS */
+export type SwitchPropertiesIOS = SwitchPropsIOS;

package/types/public/Insets.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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
+ */
+
+export interface Insets {
+  top?: number | undefined;
+  left?: number | undefined;
+  bottom?: number | undefined;
+  right?: number | undefined;
+}

package/types/public/ReactNativeRenderer.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 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 {GestureResponderEvent} from '../../Libraries/Types/CoreEventTypes';
+
+/**
+ * Gesture recognition on mobile devices is much more complicated than web.
+ * A touch can go through several phases as the app determines what the user's intention is.
+ * For example, the app needs to determine if the touch is scrolling, sliding on a widget, or tapping.
+ * This can even change during the duration of a touch. There can also be multiple simultaneous touches.
+ *
+ * The touch responder system is needed to allow components to negotiate these touch interactions
+ * without any additional knowledge about their parent or child components.
+ * This system is implemented in ResponderEventPlugin.js, which contains further details and documentation.
+ *
+ * Best Practices
+ * Users can feel huge differences in the usability of web apps vs. native, and this is one of the big causes.
+ * Every action should have the following attributes:
+ *      Feedback/highlighting- show the user what is handling their touch, and what will happen when they release the gesture
+ *      Cancel-ability- when making an action, the user should be able to abort it mid-touch by dragging their finger away
+ *
+ * These features make users more comfortable while using an app,
+ * because it allows people to experiment and interact without fear of making mistakes.
+ *
+ * TouchableHighlight and Touchable*
+ * The responder system can be complicated to use.
+ * So we have provided an abstract Touchable implementation for things that should be "tappable".
+ * This uses the responder system and allows you to easily configure tap interactions declaratively.
+ * Use TouchableHighlight anywhere where you would use a button or link on web.
+ */
+export interface GestureResponderHandlers {
+  /**
+   * A view can become the touch responder by implementing the correct negotiation methods.
+   * There are two methods to ask the view if it wants to become responder:
+   */
+
+  /**
+   * Does this view want to become responder on the start of a touch?
+   */
+  onStartShouldSetResponder?:
+    | ((event: GestureResponderEvent) => boolean)
+    | undefined;
+
+  /**
+   * Called for every touch move on the View when it is not the responder: does this view want to "claim" touch responsiveness?
+   */
+  onMoveShouldSetResponder?:
+    | ((event: GestureResponderEvent) => boolean)
+    | undefined;
+
+  /**
+   * If the View returns true and attempts to become the responder, one of the following will happen:
+   */
+
+  onResponderEnd?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   * The View is now responding for touch events.
+   * This is the time to highlight and show the user what is happening
+   */
+  onResponderGrant?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   * Something else is the responder right now and will not release it
+   */
+  onResponderReject?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   * If the view is responding, the following handlers can be called:
+   */
+
+  /**
+   * The user is moving their finger
+   */
+  onResponderMove?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   * Fired at the end of the touch, ie "touchUp"
+   */
+  onResponderRelease?: ((event: GestureResponderEvent) => void) | undefined;
+
+  onResponderStart?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   *  Something else wants to become responder.
+   *  Should this view release the responder? Returning true allows release
+   */
+  onResponderTerminationRequest?:
+    | ((event: GestureResponderEvent) => boolean)
+    | undefined;
+
+  /**
+   * The responder has been taken from the View.
+   * Might be taken by other views after a call to onResponderTerminationRequest,
+   * or might be taken by the OS without asking (happens with control center/ notification center on iOS)
+   */
+  onResponderTerminate?: ((event: GestureResponderEvent) => void) | undefined;
+
+  /**
+   * onStartShouldSetResponder and onMoveShouldSetResponder are called with a bubbling pattern,
+   * where the deepest node is called first.
+   * That means that the deepest component will become responder when multiple Views return true for *ShouldSetResponder handlers.
+   * This is desirable in most cases, because it makes sure all controls and buttons are usable.
+   *
+   * However, sometimes a parent will want to make sure that it becomes responder.
+   * This can be handled by using the capture phase.
+   * Before the responder system bubbles up from the deepest component,
+   * it will do a capture phase, firing on*ShouldSetResponderCapture.
+   * So if a parent View wants to prevent the child from becoming responder on a touch start,
+   * it should have a onStartShouldSetResponderCapture handler which returns true.
+   */
+  onStartShouldSetResponderCapture?:
+    | ((event: GestureResponderEvent) => boolean)
+    | undefined;
+
+  /**
+   * onStartShouldSetResponder and onMoveShouldSetResponder are called with a bubbling pattern,
+   * where the deepest node is called first.
+   * That means that the deepest component will become responder when multiple Views return true for *ShouldSetResponder handlers.
+   * This is desirable in most cases, because it makes sure all controls and buttons are usable.
+   *
+   * However, sometimes a parent will want to make sure that it becomes responder.
+   * This can be handled by using the capture phase.
+   * Before the responder system bubbles up from the deepest component,
+   * it will do a capture phase, firing on*ShouldSetResponderCapture.
+   * So if a parent View wants to prevent the child from becoming responder on a touch start,
+   * it should have a onStartShouldSetResponderCapture handler which returns true.
+   */
+  onMoveShouldSetResponderCapture?:
+    | ((event: GestureResponderEvent) => boolean)
+    | undefined;
+}
+
+/**
+ * React Native also implements unstable_batchedUpdates
+ */
+export function unstable_batchedUpdates<A, R>(callback: (a: A) => R, a: A): R;
+export function unstable_batchedUpdates<R>(callback: () => R): R;