[pull] main from facebook:main

.eslintrc.js

@@ -626,6 +626,7 @@ module.exports = {
     FinalizationRegistry: 'readonly',
     Exclude: 'readonly',
     Omit: 'readonly',
+    Pick: 'readonly',
     Keyframe: 'readonly',
     PropertyIndexedKeyframes: 'readonly',
     KeyframeAnimationOptions: 'readonly',

flow-typed/environments/dom.js

@@ -1415,6 +1415,8 @@ declare class Document extends Node {
   links: HTMLCollection<HTMLLinkElement>;
   media: string;
   open(url?: string, name?: string, features?: string, replace?: boolean): any;
+  /** @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/prerendering} */
+  prerendering: boolean;
   readyState: string;
   referrer: string;
   scripts: HTMLCollection<HTMLScriptElement>;

packages/react-client/flight.js

@@ -7,4 +7,11 @@
  * @flow
  */
 
+import typeof * as FlightClientAPI from './src/ReactFlightClient';
+import typeof * as HostConfig from './src/ReactFlightClientConfig';
+
 export * from './src/ReactFlightClient';
+
+// At build time, this module is wrapped as a factory function ($$$reconciler).
+// Consumers pass a host config object and get back the Flight client API.
+declare export default (hostConfig: HostConfig) => FlightClientAPI;

packages/react-client/src/forks/ReactFlightClientConfig.noop.js

@@ -0,0 +1,57 @@
+/**
+ * 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
+ */
+
+// This is a host config that's used for the internal `react-noop-renderer` package.
+//
+// Its API lets you pass the host config as an argument.
+// However, inside the `react-server` we treat host config as a module.
+// This file is a shim between two worlds.
+//
+// It works because the `react-server` bundle is wrapped in something like:
+//
+// module.exports = function ($$$config) {
+//   /* renderer code */
+// }
+//
+// So `$$$config` looks like a global variable, but it's
+// really an argument to a top-level wrapping function.
+
+declare const $$$config: $FlowFixMe;
+
+export opaque type ModuleLoading = mixed;
+export opaque type ServerConsumerModuleMap = mixed;
+export opaque type ServerManifest = mixed;
+export opaque type ServerReferenceId = string;
+export opaque type ClientReferenceMetadata = mixed;
+export opaque type ClientReference<T> = mixed; // eslint-disable-line no-unused-vars
+export const resolveClientReference = $$$config.resolveClientReference;
+export const resolveServerReference = $$$config.resolveServerReference;
+export const preloadModule = $$$config.preloadModule;
+export const requireModule = $$$config.requireModule;
+export const getModuleDebugInfo = $$$config.getModuleDebugInfo;
+export const dispatchHint = $$$config.dispatchHint;
+export const prepareDestinationForModule =
+  $$$config.prepareDestinationForModule;
+export const usedWithSSR = true;
+
+export opaque type Source = mixed;
+
+export opaque type StringDecoder = mixed;
+
+export const createStringDecoder = $$$config.createStringDecoder;
+export const readPartialStringChunk = $$$config.readPartialStringChunk;
+export const readFinalStringChunk = $$$config.readFinalStringChunk;
+
+export const bindToConsole = $$$config.bindToConsole;
+
+export const rendererVersion = $$$config.rendererVersion;
+export const rendererPackageName = $$$config.rendererPackageName;
+
+export const checkEvalAvailabilityOnceDev =
+  $$$config.checkEvalAvailabilityOnceDev;

packages/react-devtools-extensions/src/contentScripts/proxy.js

@@ -10,7 +10,7 @@
 
 'use strict';
 
-function injectProxy({target}: {target: any}) {
+function injectProxy() {
   // Firefox's behaviour for injecting this content script can be unpredictable
   // While navigating the history, some content scripts might not be re-injected and still be alive
   if (!window.__REACT_DEVTOOLS_PROXY_INJECTED__) {
@@ -32,9 +32,23 @@ function injectProxy({target}: {target: any}) {
   }
 }
 
+function handlePageShow() {
+  if (document.prerendering) {
+    // React DevTools can't handle multiple documents being connected to the same extension port.
+    // However, browsers are firing pageshow events while prerendering (https://issues.chromium.org/issues/489633225).
+    // We need to wait until prerendering is finished before injecting the proxy.
+    // In browsers with pagereveal support, listening to pagereveal would be sufficient.
+    // Waiting for prerenderingchange is a workaround to support browsers that
+    // have speculationrules but not pagereveal.
+    document.addEventListener('prerenderingchange', injectProxy, {once: true});
+  } else {
+    injectProxy();
+  }
+}
+
 window.addEventListener('pagereveal', injectProxy);
 // For backwards compat with browsers not implementing `pagereveal` which is a fairly new event.
-window.addEventListener('pageshow', injectProxy);
+window.addEventListener('pageshow', handlePageShow);
 
 window.addEventListener('pagehide', function ({target}) {
   if (target !== window.document) {

packages/react-noop-renderer/src/ReactFiberConfigNoop.js

@@ -0,0 +1,48 @@
+/**
+ * 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
+ */
+
+export * from './ReactFiberConfigNoopHydration';
+export * from './ReactFiberConfigNoopScopes';
+export * from './ReactFiberConfigNoopTestSelectors';
+export * from './ReactFiberConfigNoopResources';
+export * from './ReactFiberConfigNoopSingletons';
+// createReactNoop will overwrite these with the mutation or persistence versions.
+export * from './ReactFiberConfigNoopNoMutation';
+export * from './ReactFiberConfigNoopNoPersistence';
+
+export type HostContext = Object;
+
+export type TextInstance = {
+  text: string,
+  id: number,
+  parent: number,
+  hidden: boolean,
+  context: HostContext,
+};
+
+export type Instance = {
+  type: string,
+  id: number,
+  parent: number,
+  children: Array<Instance | TextInstance>,
+  text: string | null,
+  prop: any,
+  hidden: boolean,
+  context: HostContext,
+};
+
+export type PublicInstance = Instance;
+
+export type TransitionStatus = mixed;
+
+export type Container = {
+  rootID: string,
+  children: Array<Instance | TextInstance>,
+  pendingChildren: Array<Instance | TextInstance>,
+};

packages/react-noop-renderer/src/ReactFiberConfigNoopHydration.js

@@ -0,0 +1,65 @@
+/**
+ * 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
+ */
+
+// Renderers that don't support hydration
+// can re-export everything from this module.
+
+function shim(...args: any): empty {
+  throw new Error(
+    'react-noop-renderer does not support hydration. ' +
+      'This error is likely caused by a bug in React. ' +
+      'Please file an issue.',
+  );
+}
+
+// Hydration (when unsupported)
+export type ActivityInstance = mixed;
+export type SuspenseInstance = mixed;
+export const supportsHydration = false;
+export const isSuspenseInstancePending = shim;
+export const isSuspenseInstanceFallback = shim;
+export const getSuspenseInstanceFallbackErrorDetails = shim;
+export const registerSuspenseInstanceRetry = shim;
+export const canHydrateFormStateMarker = shim;
+export const isFormStateMarkerMatching = shim;
+export const getNextHydratableSibling = shim;
+export const getNextHydratableSiblingAfterSingleton = shim;
+export const getFirstHydratableChild = shim;
+export const getFirstHydratableChildWithinContainer = shim;
+export const getFirstHydratableChildWithinActivityInstance = shim;
+export const getFirstHydratableChildWithinSuspenseInstance = shim;
+export const getFirstHydratableChildWithinSingleton = shim;
+export const canHydrateInstance = shim;
+export const canHydrateTextInstance = shim;
+export const canHydrateActivityInstance = shim;
+export const canHydrateSuspenseInstance = shim;
+export const hydrateInstance = shim;
+export const hydrateTextInstance = shim;
+export const hydrateActivityInstance = shim;
+export const hydrateSuspenseInstance = shim;
+export const getNextHydratableInstanceAfterActivityInstance = shim;
+export const getNextHydratableInstanceAfterSuspenseInstance = shim;
+export const finalizeHydratedChildren = shim;
+export const commitHydratedInstance = shim;
+export const commitHydratedContainer = shim;
+export const commitHydratedActivityInstance = shim;
+export const commitHydratedSuspenseInstance = shim;
+export const flushHydrationEvents = shim;
+export const clearActivityBoundary = shim;
+export const clearSuspenseBoundary = shim;
+export const clearActivityBoundaryFromContainer = shim;
+export const clearSuspenseBoundaryFromContainer = shim;
+export const hideDehydratedBoundary = shim;
+export const unhideDehydratedBoundary = shim;
+export const shouldDeleteUnhydratedTailInstances = shim;
+export const diffHydratedPropsForDevWarnings = shim;
+export const diffHydratedTextForDevWarnings = shim;
+export const describeHydratableInstanceForDevWarnings = shim;
+export const validateHydratableInstance = shim;
+export const validateHydratableTextInstance = shim;

packages/react-noop-renderer/src/ReactFiberConfigNoopNoMutation.js

@@ -0,0 +1,61 @@
+/**
+ * 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
+ */
+
+// Renderers that don't support mutation
+// can re-export everything from this module.
+
+function shim(...args: any): empty {
+  throw new Error(
+    'This entrypoint of react-noop-renderer does not support mutation. ' +
+      'This error is likely caused by a bug in React. ' +
+      'Please file an issue.',
+  );
+}
+
+// Mutation (when unsupported)
+export const supportsMutation = false;
+export const cloneMutableInstance = shim;
+export const cloneMutableTextInstance = shim;
+export const appendChild = shim;
+export const appendChildToContainer = shim;
+export const commitTextUpdate = shim;
+export const commitMount = shim;
+export const commitUpdate = shim;
+export const insertBefore = shim;
+export const insertInContainerBefore = shim;
+export const removeChild = shim;
+export const removeChildFromContainer = shim;
+export const resetTextContent = shim;
+export const hideInstance = shim;
+export const hideTextInstance = shim;
+export const unhideInstance = shim;
+export const unhideTextInstance = shim;
+export const clearContainer = shim;
+export const applyViewTransitionName = shim;
+export const restoreViewTransitionName = shim;
+export const cancelViewTransitionName = shim;
+export const cancelRootViewTransitionName = shim;
+export const restoreRootViewTransitionName = shim;
+export const cloneRootViewTransitionContainer = shim;
+export const removeRootViewTransitionClone = shim;
+export type InstanceMeasurement = null;
+export const measureInstance = shim;
+export const measureClonedInstance = shim;
+export const wasInstanceInViewport = shim;
+export const hasInstanceChanged = shim;
+export const hasInstanceAffectedParent = shim;
+export const startViewTransition = shim;
+export type RunningViewTransition = null;
+export const startGestureTransition = shim;
+export const stopViewTransition = shim;
+export const addViewTransitionFinishedListener = shim;
+export type ViewTransitionInstance = null | {name: string, ...};
+export const createViewTransitionInstance = shim;
+export type GestureTimeline = any;
+export const getCurrentGestureOffset = shim;

packages/react-noop-renderer/src/ReactFiberConfigNoopNoPersistence.js

@@ -0,0 +1,29 @@
+/**
+ * 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
+ */
+
+// Renderers that don't support persistence
+// can re-export everything from this module.
+
+function shim(...args: any): empty {
+  throw new Error(
+    'This entrypoint of react-noop-renderer does not support persistence. ' +
+      'This error is likely caused by a bug in React. ' +
+      'Please file an issue.',
+  );
+}
+
+// Persistence (when unsupported)
+export const supportsPersistence = false;
+export const cloneInstance = shim;
+export const createContainerChildSet = shim;
+export const appendChildToContainerChildSet = shim;
+export const finalizeContainerChildren = shim;
+export const replaceContainerChildren = shim;
+export const cloneHiddenInstance = shim;
+export const cloneHiddenTextInstance = shim;

packages/react-noop-renderer/src/ReactFiberConfigNoopResources.js

@@ -0,0 +1,38 @@
+/**
+ * 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
+ */
+
+// Renderers that don't support hydration
+// can re-export everything from this module.
+
+function shim(...args: any): empty {
+  throw new Error(
+    'react-noop-renderer does not support Resources. ' +
+      'This error is likely caused by a bug in React. ' +
+      'Please file an issue.',
+  );
+}
+
+export type HoistableRoot = mixed;
+export type Resource = mixed;
+
+// Resources (when unsupported)
+export const supportsResources = false;
+export const isHostHoistableType = shim;
+export const getHoistableRoot = shim;
+export const getResource = shim;
+export const acquireResource = shim;
+export const releaseResource = shim;
+export const hydrateHoistable = shim;
+export const mountHoistable = shim;
+export const unmountHoistable = shim;
+export const createHoistableInstance = shim;
+export const prepareToCommitHoistables = shim;
+export const mayResourceSuspendCommit = shim;
+export const preloadResource = shim;
+export const suspendResource = shim;

packages/react-noop-renderer/src/ReactFiberConfigNoopScopes.js

@@ -0,0 +1,23 @@
+/**
+ * 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
+ */
+
+// Renderers that don't support React Scopes
+// can re-export everything from this module.
+
+function shim(...args: any): empty {
+  throw new Error(
+    'react-noop-renderer does not support React Scopes. ' +
+      'This error is likely caused by a bug in React. ' +
+      'Please file an issue.',
+  );
+}
+
+// React Scopes (when unsupported)
+export const prepareScopeUpdate = shim;
+export const getInstanceFromScope = shim;