@office-iss/react-native-win32 0.71.5 → 0.72.0-preview.2

package/Libraries/DOM/Nodes/ReadOnlyNode.js

@@ -0,0 +1,167 @@
+/**
+ * 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 strict
+ */
+
+// flowlint unsafe-getters-setters:off
+
+import type NodeList from '../OldStyleCollections/NodeList';
+import type ReadOnlyElement from './ReadOnlyElement';
+
+export default class ReadOnlyNode {
+  get childNodes(): NodeList<ReadOnlyNode> {
+    throw new TypeError('Unimplemented');
+  }
+
+  get firstChild(): ReadOnlyNode | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  get isConnected(): boolean {
+    throw new TypeError('Unimplemented');
+  }
+
+  get lastChild(): ReadOnlyNode | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  get nextSibling(): ReadOnlyNode | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  get nodeName(): string {
+    throw new TypeError('Unimplemented');
+  }
+
+  get nodeType(): number {
+    throw new TypeError('Unimplemented');
+  }
+
+  get nodeValue(): string | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  get parentElement(): ReadOnlyElement | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  get parentNode(): ReadOnlyNode | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  get previousSibling(): ReadOnlyNode | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  get textContent(): string | null {
+    throw new TypeError('Unimplemented');
+  }
+
+  compareDocumentPosition(otherNode: ReadOnlyNode): number {
+    throw new TypeError('Unimplemented');
+  }
+
+  contains(otherNode: ReadOnlyNode): boolean {
+    throw new TypeError('Unimplemented');
+  }
+
+  getRootNode(): ReadOnlyNode {
+    throw new TypeError('Unimplemented');
+  }
+
+  hasChildNodes(): boolean {
+    throw new TypeError('Unimplemented');
+  }
+
+  /*
+   * Node types, as returned by the `nodeType` property.
+   */
+
+  /**
+   * Type of Element, HTMLElement and ReactNativeElement instances.
+   */
+  static ELEMENT_NODE: number = 1;
+  /**
+   * Currently Unused in React Native.
+   */
+  static ATTRIBUTE_NODE: number = 2;
+  /**
+   * Text nodes.
+   */
+  static TEXT_NODE: number = 3;
+  /**
+   * @deprecated Unused in React Native.
+   */
+  static CDATA_SECTION_NODE: number = 4;
+  /**
+   * @deprecated
+   */
+  static ENTITY_REFERENCE_NODE: number = 5;
+  /**
+   * @deprecated
+   */
+  static ENTITY_NODE: number = 6;
+  /**
+   * @deprecated Unused in React Native.
+   */
+  static PROCESSING_INSTRUCTION_NODE: number = 7;
+  /**
+   * @deprecated Unused in React Native.
+   */
+  static COMMENT_NODE: number = 8;
+  /**
+   * @deprecated Unused in React Native.
+   */
+  static DOCUMENT_NODE: number = 9;
+  /**
+   * @deprecated Unused in React Native.
+   */
+  static DOCUMENT_TYPE_NODE: number = 10;
+  /**
+   * @deprecated Unused in React Native.
+   */
+  static DOCUMENT_FRAGMENT_NODE: number = 11;
+  /**
+   * @deprecated
+   */
+  static NOTATION_NODE: number = 12;
+
+  /*
+   * Document position flags. Used to check the return value of
+   * `compareDocumentPosition()`.
+   */
+
+  /**
+   * Both nodes are in different documents.
+   */
+  static DOCUMENT_POSITION_DISCONNECTED: number = 1;
+  /**
+   * `otherNode` precedes the node in either a pre-order depth-first traversal of a tree containing both
+   * (e.g., as an ancestor or previous sibling or a descendant of a previous sibling or previous sibling of an ancestor)
+   * or (if they are disconnected) in an arbitrary but consistent ordering.
+   */
+  static DOCUMENT_POSITION_PRECEDING: number = 2;
+  /**
+   * `otherNode` follows the node in either a pre-order depth-first traversal of a tree containing both
+   * (e.g., as a descendant or following sibling or a descendant of a following sibling or following sibling of an ancestor)
+   * or (if they are disconnected) in an arbitrary but consistent ordering.
+   */
+  static DOCUMENT_POSITION_FOLLOWING: number = 4;
+  /**
+   * `otherNode` is an ancestor of the node.
+   */
+  static DOCUMENT_POSITION_CONTAINS: number = 8;
+  /**
+   * `otherNode` is a descendant of the node.
+   */
+  static DOCUMENT_POSITION_CONTAINED_BY: number = 16;
+  /**
+   * @deprecated Unused in React Native.
+   */
+  static DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: number = 32;
+}

package/Libraries/DOM/OldStyleCollections/ArrayLikeUtils.js

@@ -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
+ * @flow strict
+ */
+
+/**
+ * This definition is different from the current built-in type `$ArrayLike`
+ * provided by Flow, in that this is an interface and that one is an object.
+ *
+ * The difference is important because, when using objects, Flow thinks
+ * a `length` property would be copied over when using the spread operator,
+ * which is incorrect.
+ */
+export interface ArrayLike<T> extends Iterable<T> {
+  // This property should've been read-only as well, but Flow doesn't handle
+  // read-only indexers correctly (thinks reads are writes and fails).
+  [indexer: number]: T;
+  +length: number;
+}
+
+export function* createValueIterator<T>(arrayLike: ArrayLike<T>): Iterator<T> {
+  for (let i = 0; i < arrayLike.length; i++) {
+    yield arrayLike[i];
+  }
+}
+
+export function* createKeyIterator<T>(
+  arrayLike: ArrayLike<T>,
+): Iterator<number> {
+  for (let i = 0; i < arrayLike.length; i++) {
+    yield i;
+  }
+}
+
+export function* createEntriesIterator<T>(
+  arrayLike: ArrayLike<T>,
+): Iterator<[number, T]> {
+  for (let i = 0; i < arrayLike.length; i++) {
+    yield [i, arrayLike[i]];
+  }
+}

package/Libraries/DOM/OldStyleCollections/DOMRectList.js

@@ -0,0 +1,76 @@
+/**
+ * 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 strict
+ */
+
+// flowlint unsafe-getters-setters:off
+
+import type DOMRectReadOnly from '../Geometry/DOMRectReadOnly';
+import type {ArrayLike} from './ArrayLikeUtils';
+
+import {createValueIterator} from './ArrayLikeUtils';
+
+// IMPORTANT: The Flow type definition for this module is defined in `DOMRectList.js.flow`
+// because Flow only supports indexers in classes in declaration files.
+
+// $FlowIssue[prop-missing] Flow doesn't understand [Symbol.iterator]() {} and thinks this class doesn't implement the Iterable interface.
+export default class DOMRectList implements Iterable<DOMRectReadOnly> {
+  _length: number;
+
+  /**
+   * Use `createDOMRectList` to create instances of this class.
+   *
+   * @private This is not defined in the declaration file, so users will not see
+   *          the signature of the constructor.
+   */
+  constructor(elements: $ReadOnlyArray<DOMRectReadOnly>) {
+    for (let i = 0; i < elements.length; i++) {
+      Object.defineProperty(this, i, {
+        value: elements[i],
+        enumerable: true,
+        configurable: false,
+        writable: false,
+      });
+    }
+
+    this._length = elements.length;
+  }
+
+  get length(): number {
+    return this._length;
+  }
+
+  item(index: number): DOMRectReadOnly | null {
+    if (index < 0 || index >= this._length) {
+      return null;
+    }
+
+    // assigning to the interface allows us to access the indexer property in a
+    // type-safe way.
+    // eslint-disable-next-line consistent-this
+    const arrayLike: ArrayLike<DOMRectReadOnly> = this;
+    return arrayLike[index];
+  }
+
+  // $FlowIssue[unsupported-syntax] Flow does not support computed properties in classes.
+  [Symbol.iterator](): Iterator<DOMRectReadOnly> {
+    return createValueIterator(this);
+  }
+}
+
+/**
+ * This is an internal method to create instances of `DOMRectList`,
+ * which avoids leaking its constructor to end users.
+ * We can do that because the external definition of `DOMRectList` lives in
+ * `DOMRectList.js.flow`, not here.
+ */
+export function createDOMRectList(
+  elements: $ReadOnlyArray<DOMRectReadOnly>,
+): DOMRectList {
+  return new DOMRectList(elements);
+}

package/Libraries/DOM/OldStyleCollections/HTMLCollection.js

@@ -0,0 +1,82 @@
+/**
+ * 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 strict
+ */
+
+// flowlint unsafe-getters-setters:off
+
+import type {ArrayLike} from './ArrayLikeUtils';
+
+import {createValueIterator} from './ArrayLikeUtils';
+
+// IMPORTANT: The type definition for this module is defined in `HTMLCollection.js.flow`
+// because Flow only supports indexers in classes in declaration files.
+
+// $FlowIssue[prop-missing] Flow doesn't understand [Symbol.iterator]() {} and thinks this class doesn't implement the Iterable<T> interface.
+export default class HTMLCollection<T> implements Iterable<T>, ArrayLike<T> {
+  _length: number;
+
+  /**
+   * Use `createHTMLCollection` to create instances of this class.
+   *
+   * @private This is not defined in the declaration file, so users will not see
+   *          the signature of the constructor.
+   */
+  constructor(elements: $ReadOnlyArray<T>) {
+    for (let i = 0; i < elements.length; i++) {
+      Object.defineProperty(this, i, {
+        value: elements[i],
+        enumerable: true,
+        configurable: false,
+        writable: false,
+      });
+    }
+
+    this._length = elements.length;
+  }
+
+  get length(): number {
+    return this._length;
+  }
+
+  item(index: number): T | null {
+    if (index < 0 || index >= this._length) {
+      return null;
+    }
+
+    // assigning to the interface allows us to access the indexer property in a
+    // type-safe way.
+    // eslint-disable-next-line consistent-this
+    const arrayLike: ArrayLike<T> = this;
+    return arrayLike[index];
+  }
+
+  /**
+   * @deprecated Unused in React Native.
+   */
+  namedItem(name: string): T | null {
+    return null;
+  }
+
+  // $FlowIssue[unsupported-syntax] Flow does not support computed properties in classes.
+  [Symbol.iterator](): Iterator<T> {
+    return createValueIterator(this);
+  }
+}
+
+/**
+ * This is an internal method to create instances of `HTMLCollection`,
+ * which avoids leaking its constructor to end users.
+ * We can do that because the external definition of `HTMLCollection` lives in
+ * `HTMLCollection.js.flow`, not here.
+ */
+export function createHTMLCollection<T>(
+  elements: $ReadOnlyArray<T>,
+): HTMLCollection<T> {
+  return new HTMLCollection(elements);
+}

package/Libraries/DOM/OldStyleCollections/NodeList.js

@@ -0,0 +1,104 @@
+/**
+ * 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 strict
+ */
+
+// flowlint unsafe-getters-setters:off
+
+import type {ArrayLike} from './ArrayLikeUtils';
+
+import {
+  createEntriesIterator,
+  createKeyIterator,
+  createValueIterator,
+} from './ArrayLikeUtils';
+
+// IMPORTANT: The Flow type definition for this module is defined in `NodeList.js.flow`
+// because Flow only supports indexers in classes in declaration files.
+
+// $FlowIssue[prop-missing] Flow doesn't understand [Symbol.iterator]() {} and thinks this class doesn't implement the Iterable<T> interface.
+export default class NodeList<T> implements Iterable<T>, ArrayLike<T> {
+  _length: number;
+
+  /**
+   * Use `createNodeList` to create instances of this class.
+   *
+   * @private This is not defined in the declaration file, so users will not see
+   *          the signature of the constructor.
+   */
+  constructor(elements: $ReadOnlyArray<T>) {
+    for (let i = 0; i < elements.length; i++) {
+      Object.defineProperty(this, i, {
+        value: elements[i],
+        writable: false,
+      });
+    }
+    this._length = elements.length;
+  }
+
+  get length(): number {
+    return this._length;
+  }
+
+  item(index: number): T | null {
+    if (index < 0 || index >= this._length) {
+      return null;
+    }
+
+    // assigning to the interface allows us to access the indexer property in a
+    // type-safe way.
+    // eslint-disable-next-line consistent-this
+    const arrayLike: ArrayLike<T> = this;
+    return arrayLike[index];
+  }
+
+  entries(): Iterator<[number, T]> {
+    return createEntriesIterator(this);
+  }
+
+  forEach<ThisType>(
+    callbackFn: (value: T, index: number, array: NodeList<T>) => mixed,
+    thisArg?: ThisType,
+  ): void {
+    // assigning to the interface allows us to access the indexer property in a
+    // type-safe way.
+    // eslint-disable-next-line consistent-this
+    const arrayLike: ArrayLike<T> = this;
+
+    for (let index = 0; index < this._length; index++) {
+      if (thisArg == null) {
+        callbackFn(arrayLike[index], index, this);
+      } else {
+        callbackFn.call(thisArg, arrayLike[index], index, this);
+      }
+    }
+  }
+
+  keys(): Iterator<number> {
+    return createKeyIterator(this);
+  }
+
+  values(): Iterator<T> {
+    return createValueIterator(this);
+  }
+
+  // $FlowIssue[unsupported-syntax] Flow does not support computed properties in classes.
+  [Symbol.iterator](): Iterator<T> {
+    return createValueIterator(this);
+  }
+}
+
+/**
+ * This is an internal method to create instances of `NodeList`,
+ * which avoids leaking its constructor to end users.
+ * We can do that because the external definition of `NodeList` lives in
+ * `NodeList.js.flow`, not here.
+ */
+export function createNodeList<T>(elements: $ReadOnlyArray<T>): NodeList<T> {
+  return new NodeList(elements);
+}

package/Libraries/DevToolsSettings/DevToolsSettingsManager.android.js

@@ -0,0 +1,35 @@
+/**
+ * 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 DevSettings from '../Utilities/DevSettings';
+import NativeDevToolsSettingsManager from './NativeDevToolsSettingsManager';
+
+module.exports = {
+  setConsolePatchSettings(newSettings: string) {
+    NativeDevToolsSettingsManager?.setConsolePatchSettings(newSettings);
+  },
+  getConsolePatchSettings(): ?string {
+    return NativeDevToolsSettingsManager?.getConsolePatchSettings();
+  },
+  setProfilingSettings(newSettings: string) {
+    if (NativeDevToolsSettingsManager?.setProfilingSettings != null) {
+      NativeDevToolsSettingsManager.setProfilingSettings(newSettings);
+    }
+  },
+  getProfilingSettings(): ?string {
+    if (NativeDevToolsSettingsManager?.getProfilingSettings != null) {
+      return NativeDevToolsSettingsManager.getProfilingSettings();
+    }
+    return null;
+  },
+  reload(): void {
+    DevSettings?.reload();
+  },
+};

package/Libraries/DevToolsSettings/DevToolsSettingsManager.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 interface DevToolsSettingsManagerStatic {
+  reload(): void;
+  setConsolePatchSettings(newSettings: string): void;
+  getConsolePatchSettings(): string | null;
+  setProfilingSettings(newSettings: string): void;
+  getProfilingSettings(): string | null;
+}
+
+export const DevToolsSettingsManager: DevToolsSettingsManagerStatic;
+export type DevToolsSettingsManager = DevToolsSettingsManagerStatic;

package/Libraries/DevToolsSettings/DevToolsSettingsManager.ios.js

@@ -0,0 +1,49 @@
+/**
+ * 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 Settings from '../Settings/Settings';
+import DevSettings from '../Utilities/DevSettings';
+
+const CONSOLE_PATCH_SETTINGS_KEY = 'ReactDevTools::ConsolePatchSettings';
+const PROFILING_SETTINGS_KEY = 'ReactDevTools::ProfilingSettings';
+
+const DevToolsSettingsManager = {
+  setConsolePatchSettings(newConsolePatchSettings: string): void {
+    Settings.set({
+      [CONSOLE_PATCH_SETTINGS_KEY]: newConsolePatchSettings,
+    });
+  },
+  getConsolePatchSettings(): ?string {
+    const value = Settings.get(CONSOLE_PATCH_SETTINGS_KEY);
+    if (typeof value === 'string') {
+      return value;
+    }
+    return null;
+  },
+
+  setProfilingSettings(newProfilingSettings: string): void {
+    Settings.set({
+      [PROFILING_SETTINGS_KEY]: newProfilingSettings,
+    });
+  },
+  getProfilingSettings(): ?string {
+    const value = Settings.get(PROFILING_SETTINGS_KEY);
+    if (typeof value === 'string') {
+      return value;
+    }
+    return null;
+  },
+
+  reload(): void {
+    DevSettings?.reload();
+  },
+};
+
+module.exports = DevToolsSettingsManager;

package/Libraries/DevToolsSettings/DevToolsSettingsManager.win32.js

@@ -0,0 +1,35 @@
+/**
+ * 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 DevSettings from '../Utilities/DevSettings';
+import NativeDevToolsSettingsManager from './NativeDevToolsSettingsManager';
+
+module.exports = {
+  setConsolePatchSettings(newSettings: string) {
+    NativeDevToolsSettingsManager?.setConsolePatchSettings(newSettings);
+  },
+  getConsolePatchSettings(): ?string {
+    return NativeDevToolsSettingsManager?.getConsolePatchSettings();
+  },
+  setProfilingSettings(newSettings: string) {
+    if (NativeDevToolsSettingsManager?.setProfilingSettings != null) {
+      NativeDevToolsSettingsManager.setProfilingSettings(newSettings);
+    }
+  },
+  getProfilingSettings(): ?string {
+    if (NativeDevToolsSettingsManager?.getProfilingSettings != null) {
+      return NativeDevToolsSettingsManager.getProfilingSettings();
+    }
+    return null;
+  },
+  reload(): void {
+    DevSettings?.reload();
+  },
+};

package/Libraries/DevToolsSettings/NativeDevToolsSettingsManager.js

@@ -0,0 +1,24 @@
+/**
+ * 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 {TurboModule} from '../TurboModule/RCTExport';
+
+import * as TurboModuleRegistry from '../TurboModule/TurboModuleRegistry';
+
+export interface Spec extends TurboModule {
+  +setConsolePatchSettings: (newConsolePatchSettings: string) => void;
+  +getConsolePatchSettings: () => ?string;
+  +setProfilingSettings?: (newProfilingSettings: string) => void;
+  +getProfilingSettings?: () => ?string;
+}
+
+export default (TurboModuleRegistry.get<Spec>(
+  'DevToolsSettingsManager',
+): ?Spec);

package/Libraries/EventEmitter/NativeEventEmitter.d.ts

@@ -7,9 +7,8 @@
  * @format
  */
 
-import {
+import EventEmitter, {
   EmitterSubscription,
-  EventEmitter,
 } from '../vendor/emitter/EventEmitter';
 
 /**

package/Libraries/EventEmitter/RCTDeviceEventEmitter.d.ts

@@ -7,9 +7,8 @@
  * @format
  */
 
-import {
+import EventEmitter, {
   EmitterSubscription,
-  EventEmitter,
   EventSubscriptionVendor,
 } from '../vendor/emitter/EventEmitter';
 

package/Libraries/EventEmitter/RCTDeviceEventEmitter.js

@@ -21,4 +21,12 @@ type RCTDeviceEventDefinitions = $FlowFixMe;
  *
  * NativeModules that emit events should instead subclass `NativeEventEmitter`.
  */
-export default (new EventEmitter(): IEventEmitter<RCTDeviceEventDefinitions>);
+const RCTDeviceEventEmitter: IEventEmitter<RCTDeviceEventDefinitions> =
+  new EventEmitter();
+
+Object.defineProperty(global, '__rctDeviceEventEmitter', {
+  configurable: true,
+  value: RCTDeviceEventEmitter,
+});
+
+export default (RCTDeviceEventEmitter: IEventEmitter<RCTDeviceEventDefinitions>);

package/Libraries/Events/EventPolyfill.js

@@ -159,7 +159,7 @@ class EventPolyfill implements IEvent {
   // data with the other in sync.
   _syntheticEvent: mixed;
 
-  constructor(type: string, eventInitDict?: Event$Init): void {
+  constructor(type: string, eventInitDict?: Event$Init) {
     this.type = type;
     this.bubbles = !!(eventInitDict?.bubbles || false);
     this.cancelable = !!(eventInitDict?.cancelable || false);