@office-iss/react-native-win32 0.0.0-canary.296 → 0.0.0-canary.298

package/src/private/webapis/structuredClone/structuredClone.js

@@ -0,0 +1,233 @@
+/**
+ * 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 DOMException from '../errors/DOMException';
+import {
+  getPlatformObjectClone,
+  isPlatformObject,
+} from '../webidl/PlatformObjects';
+
+const VALID_ERROR_NAMES = new Set([
+  'Error',
+  'EvalError',
+  'RangeError',
+  'ReferenceError',
+  'SyntaxError',
+  'TypeError',
+  'URIError',
+]);
+
+const BASIC_CONSTRUCTORS = [Number, String, Boolean, Date];
+
+const ObjectPrototype = Object.prototype;
+
+// Technicall the memory value should be a parameter in
+// `structuredCloneInternal` but as an optimization we can reuse the same map
+// and avoid allocating a new one in every call to `structuredClone`.
+// This is safe because we don't invoke user code in `structuredClone`, so at
+// any given point we only have one memory object alive anyway.
+const memory: Map<mixed, mixed> = new Map();
+
+function structuredCloneInternal<T>(value: T): T {
+  // Handles `null` and `undefined`.
+  if (value == null) {
+    return value;
+  }
+
+  // Handles remaining primitive values.
+  switch (typeof value) {
+    case 'boolean':
+    case 'number':
+    case 'string':
+    case 'bigint':
+      return value;
+  }
+
+  // Handles unsupported types (symbols and functions).
+  if (typeof value !== 'object') {
+    // value is symbol or function
+    throw new DOMException(
+      `Failed to execute 'structuredClone' on 'Window': ${String(value)} could not be cloned.`,
+      'DataCloneError',
+    );
+  }
+
+  // Handles circular references.
+  if (memory.has(value)) {
+    // $FlowExpectedError[incompatible-return] we know memory.get(value) is T
+    return memory.get(value);
+  }
+
+  // Handles arrays.
+  if (Array.isArray(value)) {
+    const result = [];
+    memory.set(value, result);
+
+    for (const key of Object.keys(value)) {
+      result[key] = structuredCloneInternal(value[key]);
+    }
+
+    // $FlowExpectedError[incompatible-return] we know result is T
+    return result;
+  }
+
+  // Simple object fast path
+  // $FlowIssue[prop-missing] Why doesn't Flow know about Object.prototype?
+  if (Object.getPrototypeOf(value) === ObjectPrototype) {
+    const result = {};
+    memory.set(value, result);
+
+    for (const key of Object.keys(value)) {
+      // $FlowExpectedError[prop-missing]
+      result[key] = structuredCloneInternal(value[key]);
+    }
+
+    // $FlowExpectedError[incompatible-return] we know result is T
+    return result;
+  }
+
+  // Handles complex types (typeof === 'object').
+
+  for (const Cls of BASIC_CONSTRUCTORS) {
+    if (value instanceof Cls) {
+      const result = new Cls(value);
+      memory.set(value, result);
+      // $FlowExpectedError[incompatible-return] we know result is T
+      return result;
+    }
+  }
+
+  if (value instanceof Map) {
+    const result = new Map<mixed, mixed>();
+    memory.set(value, result);
+
+    for (const [innerKey, innerValue] of value) {
+      result.set(
+        structuredCloneInternal(innerKey),
+        structuredCloneInternal(innerValue),
+      );
+    }
+
+    // $FlowExpectedError[incompatible-return] we know result is T
+    return result;
+  }
+
+  if (value instanceof Set) {
+    const result = new Set<mixed>();
+    memory.set(value, result);
+
+    for (const innerValue of value) {
+      result.add(structuredCloneInternal(innerValue));
+    }
+
+    // $FlowExpectedError[incompatible-return] we know result is T
+    return result;
+  }
+
+  if (value instanceof RegExp) {
+    const result = new RegExp(value.source, value.flags);
+    memory.set(value, result);
+
+    // $FlowExpectedError[incompatible-return] we know result is T
+    return result;
+  }
+
+  // We need to check platform objects before `Error` because `DOMException`
+  // is a platform object AND an `Error` subclass.
+  const clone = getPlatformObjectClone(value);
+  if (clone != null) {
+    const result = clone(value);
+    memory.set(value, result);
+    return result;
+  }
+
+  if (value instanceof Error) {
+    const result = value.cause
+      ? new Error(value.message, {cause: value.cause})
+      : new Error(value.message);
+    memory.set(value, result);
+
+    if (VALID_ERROR_NAMES.has(value.name)) {
+      result.name = value.name;
+    } else {
+      result.name = 'Error';
+    }
+
+    result.stack = value.stack;
+
+    // $FlowExpectedError[incompatible-return] we know result is T
+    return result;
+  }
+
+  // Known non-serializable objects.
+  if (isNonSerializableObject(value) || isPlatformObject(value)) {
+    throw new DOMException(
+      `Failed to execute 'structuredClone' on 'Window': ${String(value)} could not be cloned.`,
+      'DataCloneError',
+    );
+  }
+
+  // Arbitrary object slow path
+  const result = {};
+  memory.set(value, result);
+
+  // We need to use Object.keys instead of iterating by indices because we
+  // also need to copy arbitrary fields set in the array.
+  for (const key of Object.keys(value)) {
+    // $FlowExpectedError[prop-missing]
+    result[key] = structuredCloneInternal(value[key]);
+  }
+
+  // $FlowExpectedError[incompatible-return] we know result is T
+  return result;
+}
+
+/**
+ * Basic implementation of `structuredClone`.
+ * See:
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Window/structuredClone.
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
+ * - https://html.spec.whatwg.org/multipage/structured-data.html#structured-cloning
+ *
+ * Supports cloning all built-in types supported by the spec, circular
+ * references and referential equality of the same objects found in the
+ * structure.
+ *
+ * Shortcuts:
+ * - This implementation does NOT serialize and deserialize the value
+ *   but implements the cloning in a single step.
+ *
+ * Known limitations:
+ * - It does not support transfering values.
+ */
+export default function structuredClone<T>(value: T): T {
+  try {
+    return structuredCloneInternal(value);
+  } finally {
+    memory.clear();
+  }
+}
+
+const NON_SERIALIZABLE_OBJECT_KEY = Symbol('nonSerializableObject');
+
+function isNonSerializableObject<T: interface {}>(obj: T): boolean {
+  // $FlowExpectedError[invalid-in-lhs]
+  return NON_SERIALIZABLE_OBJECT_KEY in obj;
+}
+
+function markClassAsNonSerializable<T>(cls: Class<T>): void {
+  // $FlowExpectedError[incompatible-use]
+  cls.prototype[NON_SERIALIZABLE_OBJECT_KEY] = true;
+}
+
+// Non-serializable built-ins.
+markClassAsNonSerializable(WeakMap);
+markClassAsNonSerializable(WeakSet);
+markClassAsNonSerializable(Promise);

package/src/private/webapis/utils/ArrayLikeUtils.js

@@ -4,8 +4,8 @@
  * 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
+ * @format
  */
 
 /**

package/src/private/webapis/webidl/PlatformObjects.js

@@ -0,0 +1,59 @@
+/**
+ * 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
+ */
+
+const IS_PLATFORM_OBJECT_KEY = Symbol('isPlatformObject');
+const CLONE_PLATFORM_OBJECT_KEY = Symbol('clonePlatformObject');
+
+/**
+ * Marks the given object or instances of the given class as platform objects.
+ *
+ * Optionally, it sets the clone function for that platform object, which is a
+ * simplification of the serializable attribute of the Web interface.
+ */
+export const setPlatformObject: (<T: interface {}>(
+  obj: Class<T>,
+  options?: {clone: T => T},
+) => void) &
+  (<T: interface {}>(obj: T, options?: {clone: T => T}) => void) =
+  function setPlatformObject(obj, options) {
+    if (typeof obj === 'function') {
+      // $FlowExpectedError[prop-missing]
+      obj.prototype[IS_PLATFORM_OBJECT_KEY] = true;
+      if (options) {
+        // $FlowExpectedError[prop-missing]
+        obj.prototype[CLONE_PLATFORM_OBJECT_KEY] = options.clone;
+      }
+    } else {
+      // $FlowExpectedError[prop-missing]
+      obj[IS_PLATFORM_OBJECT_KEY] = true;
+      if (options) {
+        // $FlowExpectedError[prop-missing]
+        obj[CLONE_PLATFORM_OBJECT_KEY] = options.clone;
+      }
+    }
+  };
+
+/**
+ * Indicates if the given object is a platform object.
+ */
+export function isPlatformObject<T: interface {}>(obj: T): boolean {
+  // $FlowExpectedError[invalid-in-lhs]
+  return IS_PLATFORM_OBJECT_KEY in obj;
+}
+
+/**
+ * Returns the clone function for the given platform object, if it was set.
+ */
+export function getPlatformObjectClone<T: interface {}>(
+  obj: T,
+): (T => T) | void {
+  // $FlowExpectedError[prop-missing]
+  return obj[CLONE_PLATFORM_OBJECT_KEY];
+}

package/src/types/globals.d.ts

@@ -57,6 +57,48 @@ declare global {
 
   const HermesInternal: null | {};
 
+  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly) */
+  interface DOMRectReadOnly {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/bottom) */
+    readonly bottom: number;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/height) */
+    readonly height: number;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/left) */
+    readonly left: number;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/right) */
+    readonly right: number;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/top) */
+    readonly top: number;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/width) */
+    readonly width: number;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/x) */
+    readonly x: number;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/y) */
+    readonly y: number;
+    toJSON(): any;
+  }
+
+  interface DOMRect extends DOMRectReadOnly {
+    height: number;
+    width: number;
+    x: number;
+    y: number;
+  }
+
+  interface DOMRectInit {
+    height?: number | undefined;
+    width?: number | undefined;
+    x?: number | undefined;
+    y?: number | undefined;
+  }
+
+  var DOMRect: {
+    prototype: DOMRect;
+    new (x?: number, y?: number, width?: number, height?: number): DOMRect;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRect/fromRect_static) */
+    fromRect(other?: DOMRectInit): DOMRect;
+  };
+
   // #region Timer Functions
 
   function clearInterval(handle: number): void;

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

@@ -13,11 +13,13 @@ import {GestureResponderHandlers} from 'react-native/types/public/ReactNativeRen
 import {StyleProp} from 'react-native/Libraries/StyleSheet/StyleSheet';
 import {ViewStyle} from 'react-native/Libraries/StyleSheet/StyleSheetTypes';
 import {
+  BlurEvent,
+  FocusEvent,
   LayoutChangeEvent,
+  PointerEvents,
   MouseEvent, // Win32
   NativeSyntheticEvent, // Win32
-  PointerEvents,
-} from 'react-native/Libraries/Types/CoreEventTypes';
+} from '../../Types/CoreEventTypes';
 import {Touchable} from 'react-native/Libraries/Components/Touchable/Touchable';
 import {AccessibilityProps} from './ViewAccessibility';
 
@@ -81,6 +83,20 @@ export interface ViewPropsIOS extends TVViewPropsIOS {
 }
 
 export interface ViewPropsAndroid {
+  /**
+   * Callback that is called when the view is blurred.
+   *
+   * Note: This will only be called if the view is focusable.
+   */
+  onBlur?: ((e: BlurEvent) => void) | null | undefined;
+
+  /**
+   * Callback that is called when the view is focused.
+   *
+   * Note: This will only be called if the view is focusable.
+   */
+  onFocus?: ((e: FocusEvent) => void) | null | undefined;
+
   /**
    * Whether this view should render itself (and all of its children) into a single hardware texture on the GPU.
    *

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

@@ -296,6 +296,13 @@ export interface TextProps
    * Controls how touch events are handled. Similar to `View`'s `pointerEvents`.
    */
   pointerEvents?: ViewStyle['pointerEvents'] | undefined;
+
+  /**
+   * Defines how far your touch may move off of the button, before deactivating the button.
+   */
+  pressRetentionOffset?:
+    | {top: number; left: number; bottom: number; right: number}
+    | undefined;
 }
 
 /**

package/types/index.d.ts

@@ -68,7 +68,7 @@
 /// <reference path="modules/BatchedBridge.d.ts" />
 /// <reference path="modules/Codegen.d.ts" />
 /// <reference path="modules/Devtools.d.ts" />
-/// <reference types="../src/types/globals.d.ts" />
+/// <reference path="../src/types/globals.d.ts" />
 
 export * from '../Libraries/ActionSheetIOS/ActionSheetIOS';
 export * from '../Libraries/Alert/Alert';

package/types/modules/Devtools.d.ts

@@ -9,24 +9,38 @@
 
 declare module 'react-native/Libraries/Core/Devtools/parseErrorStack' {
   export type StackFrame = {
-    file: string;
+    column: number | null | undefined;
+    file: string | null | undefined;
+    lineNumber: number | null | undefined;
     methodName: string;
-    lineNumber: number;
-    column: number | null;
   };
 
-  export interface ExtendedError extends Error {
-    framesToPop?: number | undefined;
-  }
-
-  export default function parseErrorStack(error: ExtendedError): StackFrame[];
+  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<StackFrame[]>;
+  ): Promise<SymbolicatedStackTrace>;
 }

package/Libraries/Interaction/JSEventLoopWatchdog.js

@@ -1,88 +0,0 @@
-/**
- * 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
- */
-
-'use strict';
-
-const infoLog = require('../Utilities/infoLog').default;
-
-type Handler = {
-  onIterate?: () => void,
-  onStall: (params: {lastInterval: number, busyTime: number, ...}) => ?string,
-  ...
-};
-
-/**
- * A utility for tracking stalls in the JS event loop that prevent timers and
- * other events from being processed in a timely manner.
- *
- * The "stall" time is defined as the amount of time in access of the acceptable
- * threshold, which is typically around 100-200ms. So if the threshold is set to
- * 100 and a timer fires 150 ms later than it was scheduled because the event
- * loop was tied up, that would be considered a 50ms stall.
- *
- * By default, logs stall events to the console when installed. Can also be
- * queried with `getStats`.
- */
-const JSEventLoopWatchdog = {
-  getStats: function (): Object {
-    return {stallCount, totalStallTime, longestStall, acceptableBusyTime};
-  },
-  reset: function () {
-    infoLog('JSEventLoopWatchdog: reset');
-    totalStallTime = 0;
-    stallCount = 0;
-    longestStall = 0;
-    lastInterval = global.performance.now();
-  },
-  addHandler: function (handler: Handler) {
-    handlers.push(handler);
-  },
-  install: function ({thresholdMS}: {thresholdMS: number, ...}) {
-    acceptableBusyTime = thresholdMS;
-    if (installed) {
-      return;
-    }
-    installed = true;
-    lastInterval = global.performance.now();
-    function iteration() {
-      const now = global.performance.now();
-      const busyTime = now - lastInterval;
-      if (busyTime >= thresholdMS) {
-        const stallTime = busyTime - thresholdMS;
-        stallCount++;
-        totalStallTime += stallTime;
-        longestStall = Math.max(longestStall, stallTime);
-        let msg =
-          `JSEventLoopWatchdog: JS thread busy for ${busyTime}ms. ` +
-          `${totalStallTime}ms in ${stallCount} stalls so far. `;
-        handlers.forEach(handler => {
-          msg += handler.onStall({lastInterval, busyTime}) || '';
-        });
-        infoLog(msg);
-      }
-      handlers.forEach(handler => {
-        handler.onIterate && handler.onIterate();
-      });
-      lastInterval = now;
-      setTimeout(iteration, thresholdMS / 5);
-    }
-    iteration();
-  },
-};
-
-let acceptableBusyTime = 0;
-let installed = false;
-let totalStallTime = 0;
-let stallCount = 0;
-let longestStall = 0;
-let lastInterval = 0;
-const handlers: Array<Handler> = [];
-
-export default JSEventLoopWatchdog;

package/flow/HermesInternalType.js

@@ -1,114 +0,0 @@
-/**
- * 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
- */
-
-// Declarations for functionality exposed by the Hermes VM.
-//
-// For backwards-compatibility, code that uses such functionality must also
-// check explicitly at run-time whether the object(s) and method(s) exist, and
-// fail safely if not.
-
-/**
- * HermesInternalType is an object containing functions used to interact with
- * the VM in a way that is not standardized by the JS spec.
- * There are limited guarantees about these functions, and they should not be
- * widely used. Consult with the Hermes team before using any of these.
- * There may be other visible properties on this object; however, those are
- * only exposed for testing purposes: do not use them.
- */
-declare type $HermesInternalType = {
-  // All members are optional because they may not exist when OTA'd to older
-  // VMs.
-
-  +getNumGCs?: () => number,
-  +getGCTime?: () => number,
-  +getNativeCallTime?: () => number,
-  +getNativeCallCount?: () => number,
-  +getGCCPUTime?: () => number,
-
-  /**
-   * Hermes can embed an "epilogue" to the bytecode file with arbitrary bytes.
-   * At most one epilogue will exist per bytecode module (which can be
-   * different than a JS module).
-   * Calling this function will return all such epilogues and convert the
-   * bytes to numbers in the range of 0-255.
-   */
-  +getEpilogues?: () => Array<Array<number>>,
-
-  /**
-   * Query the VM for various statistics about performance.
-   * There are no guarantees about what keys exist in it, but they can be
-   * printed for informational purposes.
-   * @return An object that maps strings to various types of performance
-   *    statistics.
-   */
-  +getInstrumentedStats?: () => {[string]: number | string, ...},
-
-  /**
-   * Query the VM for any sort of runtime properties that it wants to report.
-   * There are no guarantees about what keys exist in it, but they can be
-   * printed for informational purposes.
-   * @return An object that maps strings to various types of runtime properties.
-   */
-  +getRuntimeProperties?: () => {
-    'OSS Release Version': string,
-    Build: string,
-    [string]: mixed,
-  },
-
-  /**
-   * Tell Hermes that at this point the surface has transitioned from TTI to
-   * post-TTI. The VM can change some of its internal behavior to optimize for
-   * post-TTI scenarios.
-   * This can be called several times but will have no effect after the first
-   * call.
-   */
-  +ttiReached?: () => void,
-
-  /**
-   * Tell Hermes that at this point the surface has transitioned from TTRC to
-   * post-TTRC. The VM can change some of its internal behavior to optimize for
-   * post-TTRC scenarios.
-   * This can be called several times but will have no effect after the first
-   * call.
-   */
-  +ttrcReached?: () => void,
-
-  /**
-   * Query the VM to see whether or not it enabled Promise.
-   */
-  +hasPromise?: () => boolean,
-
-  /**
-   * Enable promise rejection tracking with the given options.
-   * The API mirrored the `promise` npm package, therefore it's typed same as
-   * the `enable` function of module `promise/setimmediate/rejection-tracking`
-   * declared in ./flow-typed/npm/promise_v8.x.x.js.
-   */
-  +enablePromiseRejectionTracker?: (
-    options: ?{
-      whitelist?: ?Array<mixed>,
-      allRejections?: ?boolean,
-      onUnhandled?: ?(number, mixed) => void,
-      onHandled?: ?(number, mixed) => void,
-    },
-  ) => void,
-
-  /**
-   * Query the VM to see whether or not it use the engine Job queue.
-   */
-  +useEngineQueue?: () => boolean,
-
-  /**
-   * Enqueue a JavaScript callback function as a Job into the engine Job queue.
-   */
-  +enqueueJob?: <TArguments: Array<mixed>>(
-    jobCallback: (...args: TArguments) => mixed,
-  ) => void,
-};