react-native 0.87.0-rc.0 → 0.87.0-rc.1

package/src/unstable-internals-do-not-use.d.ts

@@ -0,0 +1,214 @@
+/**
+ * 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
+ */
+
+// ----------------------------------------------------------------------------
+// Types entry point for react-native/unstable-internals-do-not-use.
+//
+// IMPORTANT: Keep this file in sync with unstable-internals-do-not-use.js.
+// ----------------------------------------------------------------------------
+
+import type * as React from 'react';
+
+// #region AppContainer
+
+interface AppContainerProps {
+  children?: React.ReactNode | undefined;
+  rootTag: number;
+  initialProps?: object | undefined;
+  WrapperComponent?: React.ComponentType<any> | null | undefined;
+  rootViewStyle?: unknown | undefined;
+  internal_excludeLogBox?: boolean | undefined;
+  internal_excludeInspector?: boolean | undefined;
+}
+
+/** Root component that wraps and mounts a React Native app tree. */
+export const AppContainer: React.ComponentType<AppContainerProps>;
+
+// #endregion
+// #region AssetSourceResolver
+
+interface ResolvedAssetSource {
+  readonly __packager_asset: boolean;
+  readonly width: number | null | undefined;
+  readonly height: number | null | undefined;
+  readonly uri: string;
+  readonly scale: number;
+}
+
+/** Resolves a packager asset descriptor to a loadable source for the current platform. */
+export class AssetSourceResolver {
+  serverUrl: string | null | undefined;
+  jsbundleUrl: string | null | undefined;
+  asset: unknown;
+  constructor(
+    serverUrl: string | null | undefined,
+    jsbundleUrl: string | null | undefined,
+    asset: unknown,
+  );
+  isLoadedFromServer(): boolean;
+  isLoadedFromFileSystem(): boolean;
+  defaultAsset(): ResolvedAssetSource;
+  getAssetUsingResolver(resolver: 'android' | 'generic'): ResolvedAssetSource;
+  assetServerURL(): ResolvedAssetSource;
+  scaledAssetPath(): ResolvedAssetSource;
+  scaledAssetURLNearBundle(): ResolvedAssetSource;
+  resourceIdentifierWithoutScale(): ResolvedAssetSource;
+  drawableFolderInBundle(): ResolvedAssetSource;
+  fromSource(source: string): ResolvedAssetSource;
+  static pickScale(scales: number[], deviceScale?: number): number;
+}
+
+// #endregion
+// #region customDirectEventTypes
+
+/** Registry mapping custom direct (non-bubbling) event names to their registration names. */
+export const customDirectEventTypes: {
+  [eventName: string]: Readonly<{
+    registrationName: string;
+  }>;
+};
+
+// #endregion
+// #region DevLoadingView
+
+/** Dev-only overlay banner showing bundle load, refresh, and error status. */
+export const DevLoadingView: {
+  showMessage(
+    message: string,
+    type: 'load' | 'refresh' | 'error',
+    options?: {dismissButton?: boolean | undefined},
+  ): void;
+  hide(): void;
+};
+
+// #endregion
+// #region getDevServer
+
+interface DevServerInfo {
+  url: string;
+  fullBundleUrl: string | null;
+  bundleLoadedFromServer: boolean;
+}
+
+/** Returns information about the running dev server. */
+export function getDevServer(): DevServerInfo;
+
+// #endregion
+// #region HMRClient
+
+/** Client that receives Fast Refresh updates and applies them at runtime. */
+export class HMRClient {
+  enable(): void;
+  disable(): void;
+  registerBundle(requestUrl: string): void;
+  log(
+    level:
+      | 'trace'
+      | 'info'
+      | 'warn'
+      | 'error'
+      | 'log'
+      | 'group'
+      | 'groupCollapsed'
+      | 'groupEnd'
+      | 'debug',
+    data: ReadonlyArray<unknown>,
+  ): void;
+  setup(
+    platform: string,
+    bundleEntry: string,
+    host: string,
+    port: number | string,
+    isEnabled: boolean,
+    scheme?: string,
+  ): void;
+}
+
+// #endregion
+// #region NativeExceptionsManager
+
+interface StackFrame {
+  column: number | null;
+  file: string | null;
+  lineNumber: number | null;
+  methodName: string;
+  collapse?: boolean | undefined;
+}
+
+interface ExceptionData {
+  message: string;
+  originalMessage: string | null;
+  name: string | null;
+  componentStack: string | null;
+  stack: StackFrame[];
+  id: number;
+  isFatal: boolean;
+  extraData?: object | undefined;
+}
+
+/** Reports JS exceptions to native and manages RedBox. */
+export const NativeExceptionsManager: {
+  reportFatalException(
+    message: string,
+    stack: StackFrame[],
+    exceptionId: number,
+  ): void;
+  reportSoftException(
+    message: string,
+    stack: StackFrame[],
+    exceptionId: number,
+  ): void;
+  dismissRedbox(): void;
+  reportException(data: ExceptionData): void;
+};
+
+// #endregion
+// #region NativeRedBox
+
+interface NativeRedBoxSpec {
+  setExtraData(extraData: object, forIdentifier: string): void;
+  dismiss(): void;
+}
+
+/** Native module for the RedBox error overlay; null when unavailable. */
+export const NativeRedBox: NativeRedBoxSpec | null;
+
+// #endregion
+// #region NativeSourceCode
+
+interface SourceCodeConstants {
+  scriptURL: string;
+}
+
+/** Native module exposing source-code constants such as the bundle scriptURL. */
+export const NativeSourceCode: {
+  getConstants(): SourceCodeConstants;
+};
+
+// #endregion
+// #region PressabilityDebugView
+
+type Rect = Readonly<{
+  bottom?: number | null | undefined;
+  left?: number | null | undefined;
+  right?: number | null | undefined;
+  top?: number | null | undefined;
+}>;
+
+type RectOrSize = Rect | number;
+
+interface PressabilityDebugViewProps {
+  color: unknown;
+  hitSlop: RectOrSize | null | undefined;
+}
+
+/** Debug overlay that visualizes press targets when enabled via the Inspector. */
+export const PressabilityDebugView: React.ComponentType<PressabilityDebugViewProps>;
+
+// #endregion

package/src/unstable-internals-do-not-use.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.
+ *
+ * @noflow
+ * @format
+ */
+
+'use strict';
+'use client';
+
+// ----------------------------------------------------------------------------
+// react-native/unstable-internals-do-not-use
+//
+// UNSTABLE WITH NO SEMVER GUARANTEES.
+// SHOULD NOT BE DEPENDED ON BY NEW CODE.
+//
+// This is a secondary entry point for frameworks and libraries that depend on
+// specific React Native internals, serving as a compatibility bridge.
+//
+// Consuming codebases must opt in via tsconfig.json:
+//   "customConditions": ["react-native-unstable-internals"]
+//
+// Having this entry point:
+// - Maintains a known list of which React Native internals are in use.
+// - Enables us to relocate supporting files more freely.
+// - Gives us time to decide on the future of these APIs (independent from
+//   removal of the Strict API opt out).
+//
+// The long term future of these exports is to formalize/delete them where
+// appropriate, and collapse this entry point.
+//
+// Replaces RFC0985
+// https://github.com/react-native-community/discussions-and-proposals/pull/985
+// where we reviewed internal APIs used in the ecosystem.
+//
+// IMPORTANT: Keep this file in sync with unstable-internals-do-not-use.d.ts.
+// ----------------------------------------------------------------------------
+
+// eslint-disable-next-line @react-native/monorepo/no-commonjs-exports
+module.exports = {
+  get AppContainer() {
+    return require('../Libraries/ReactNative/AppContainer').default;
+  },
+  get AssetSourceResolver() {
+    return require('../Libraries/Image/AssetSourceResolver').default;
+  },
+  get customDirectEventTypes() {
+    return require('../Libraries/Renderer/shims/ReactNativeViewConfigRegistry')
+      .customDirectEventTypes;
+  },
+  get DevLoadingView() {
+    return require('../Libraries/Utilities/DevLoadingView').default;
+  },
+  get getDevServer() {
+    return require('../Libraries/Core/Devtools/getDevServer').default;
+  },
+  get HMRClient() {
+    return require('../Libraries/Utilities/HMRClient').default;
+  },
+  get NativeExceptionsManager() {
+    return require('../Libraries/Core/NativeExceptionsManager').default;
+  },
+  get NativeRedBox() {
+    return require('../Libraries/NativeModules/specs/NativeRedBox').default;
+  },
+  get NativeSourceCode() {
+    return require('../Libraries/NativeModules/specs/NativeSourceCode').default;
+  },
+  get PressabilityDebugView() {
+    return require('../Libraries/Pressability/PressabilityDebug')
+      .PressabilityDebugView;
+  },
+};

package/types_generated/Libraries/ReactPrivate/ReactNativePrivateInterface.d.ts

@@ -4,29 +4,14 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<01b91d7159f100a845fa121b57f3218d>>
+ * @generated SignedSource<<449bbe3a2d07ab8a97f94597606ba139>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/Libraries/ReactPrivate/ReactNativePrivateInterface.js.flow
  */
 
-import type { createPublicTextInstance as $$IMPORT_TYPEOF_1$$ } from "../ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance";
-type createPublicTextInstanceT = typeof $$IMPORT_TYPEOF_1$$;
-export type { PublicRootInstance } from "../ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance";
-export type PublicTextInstance = ReturnType<createPublicTextInstanceT>;
-export { default as BatchedBridge } from "../BatchedBridge/BatchedBridge";
-export { default as ExceptionsManager } from "../Core/ExceptionsManager";
-export { default as Platform } from "../Utilities/Platform";
-export { default as RCTEventEmitter } from "../EventEmitter/RCTEventEmitter";
-export * as ReactNativeViewConfigRegistry from "../Renderer/shims/ReactNativeViewConfigRegistry";
-export { default as TextInputState } from "../Components/TextInput/TextInputState";
-export { default as UIManager } from "../ReactNative/UIManager";
-export { default as deepDiffer } from "../Utilities/differ/deepDiffer";
-export { default as deepFreezeAndThrowOnMutationInDev } from "../Utilities/deepFreezeAndThrowOnMutationInDev";
-export { default as flattenStyle } from "../StyleSheet/flattenStyle";
-export { default as ReactFiberErrorDialog } from "../Core/ReactFiberErrorDialog";
-export { default as legacySendAccessibilityEvent } from "../Components/AccessibilityInfo/legacySendAccessibilityEvent";
-export { default as RawEventEmitter } from "../Core/RawEventEmitter";
-export { default as CustomEvent } from "../../src/private/webapis/dom/events/CustomEvent";
-export { create as createAttributePayload, diff as diffAttributePayloads } from "../ReactNative/ReactFabricPublicInstance/ReactNativeAttributePayload";
-export { createPublicRootInstance, createPublicInstance, createPublicTextInstance, getNativeTagFromPublicInstance, getNodeFromPublicInstance, getInternalInstanceHandleFromPublicInstance } from "../ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance";
+/**
+ * @deprecated Since 0.88. Use 'react-native/react-private-interface' instead.
+ */
+export type * from "../../src/react-private-interface";
+export * from "../../src/react-private-interface";

package/types_generated/index.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * @generated SignedSource<<19fa05080365a8e46925f6d0ab8127a8>>
+ * @generated SignedSource<<e97e3c47b4192fcbc62a9957d6f5f6e8>>
  *
  * This file was translated from Flow by scripts/js-api/build-types/index.js.
  * Original file: packages/react-native/index.js.flow
@@ -59,7 +59,6 @@ export { NativeText as unstable_NativeText } from "./Libraries/Text/TextNativeCo
 export { default as unstable_TextAncestorContext } from "./Libraries/Text/TextAncestorContext";
 export type { AutoCapitalize, EnterKeyHintTypeOptions, KeyboardTypeOptions, InputModeOptions, TextContentType, TextInputAndroidProps, TextInputInstance, TextInputIOSProps, TextInputProps, TextInputBlurEvent, TextInputChangeEvent, TextInputContentSizeChangeEvent, TextInputEndEditingEvent, TextInputFocusEvent, TextInputKeyPressEvent, TextInputSelectionChangeEvent, TextInputSubmitEditingEvent, ReturnKeyTypeOptions, SubmitBehavior } from "./Libraries/Components/TextInput/TextInput";
 export { default as TextInput } from "./Libraries/Components/TextInput/TextInput";
-export { default as Touchable } from "./Libraries/Components/Touchable/Touchable";
 export type { TouchableHighlightInstance, TouchableHighlightProps } from "./Libraries/Components/Touchable/TouchableHighlight";
 export { default as TouchableHighlight } from "./Libraries/Components/Touchable/TouchableHighlight";
 export type { TouchableNativeFeedbackInstance, TouchableNativeFeedbackProps } from "./Libraries/Components/Touchable/TouchableNativeFeedback";

package/types_generated/src/private/renderer/events/dispatchNativeEvent.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ *
+ * @generated SignedSource<<1028d478babdabc71e24ec4ba8a83745>>
+ *
+ * This file was translated from Flow by scripts/js-api/build-types/index.js.
+ * Original file: packages/react-native/src/private/renderer/events/dispatchNativeEvent.js
+ */
+
+import type EventTarget from "../../webapis/dom/events/EventTarget";
+/**
+ * Dispatches a native event through the EventTarget-based dispatch system.
+ * This handles:
+ * 1. Responder negotiation (touch handling, grant/release lifecycle)
+ * 2. Normal event dispatch via dispatchTrustedEvent (capture/bubble phases)
+ *
+ * Called from the React renderer's dispatchEvent when
+ * enableNativeEventTargetEventDispatching is enabled.
+ */
+declare function dispatchNativeEvent(target: EventTarget, type: string, payload: {
+  [$$Key$$: string]: unknown;
+}): void;
+export default dispatchNativeEvent;

package/types_generated/src/react-private-interface.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ *
+ * @generated SignedSource<<43644da4b4f4c04a0f152e538ac03b9e>>
+ *
+ * This file was translated from Flow by scripts/js-api/build-types/index.js.
+ * Original file: packages/react-native/src/react-private-interface.js.flow
+ */
+
+import type { createPublicTextInstance as $$IMPORT_TYPEOF_1$$ } from "../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance";
+type createPublicTextInstanceT = typeof $$IMPORT_TYPEOF_1$$;
+export type { PublicRootInstance } from "../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance";
+export type PublicTextInstance = ReturnType<createPublicTextInstanceT>;
+export { default as BatchedBridge } from "../Libraries/BatchedBridge/BatchedBridge";
+export { default as ExceptionsManager } from "../Libraries/Core/ExceptionsManager";
+export { default as Platform } from "../Libraries/Utilities/Platform";
+export { default as RCTEventEmitter } from "../Libraries/EventEmitter/RCTEventEmitter";
+export * as ReactNativeViewConfigRegistry from "../Libraries/Renderer/shims/ReactNativeViewConfigRegistry";
+export { default as TextInputState } from "../Libraries/Components/TextInput/TextInputState";
+export { default as UIManager } from "../Libraries/ReactNative/UIManager";
+export { default as deepDiffer } from "../Libraries/Utilities/differ/deepDiffer";
+export { default as deepFreezeAndThrowOnMutationInDev } from "../Libraries/Utilities/deepFreezeAndThrowOnMutationInDev";
+export { default as flattenStyle } from "../Libraries/StyleSheet/flattenStyle";
+export { default as ReactFiberErrorDialog } from "../Libraries/Core/ReactFiberErrorDialog";
+export { default as legacySendAccessibilityEvent } from "../Libraries/Components/AccessibilityInfo/legacySendAccessibilityEvent";
+export { default as RawEventEmitter } from "../Libraries/Core/RawEventEmitter";
+export { default as CustomEvent } from "./private/webapis/dom/events/CustomEvent";
+export { create as createAttributePayload, diff as diffAttributePayloads } from "../Libraries/ReactNative/ReactFabricPublicInstance/ReactNativeAttributePayload";
+export { createPublicRootInstance, createPublicInstance, createPublicTextInstance, getNativeTagFromPublicInstance, getNodeFromPublicInstance, getInternalInstanceHandleFromPublicInstance } from "../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance";
+export { default as dispatchNativeEvent } from "./private/renderer/events/dispatchNativeEvent";

package/jest-preset.js

@@ -1,26 +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.
- *
- * @noflow
- * @format
- */
-
-'use strict';
-
-try {
-  module.exports = require('@react-native/jest-preset');
-} catch (error) {
-  if (error.code === 'MODULE_NOT_FOUND') {
-    throw new Error(
-      `The React Native Jest preset has moved to a separate package.
-To migrate, please install "@react-native/jest-preset" and update your
-jest.config.js to reference:
-  preset: '@react-native/jest-preset'`,
-    );
-  } else {
-    throw error;
-  }
-}

package/rn-get-polyfills.js

@@ -1,13 +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-local
- * @format
- */
-
-'use strict';
-
-module.exports = require('@react-native/js-polyfills');

package/types/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "module": "commonjs",
-    "lib": ["es6"],
-    "strict": false,
-    "noImplicitAny": true,
-    "noImplicitThis": true,
-    "strictFunctionTypes": true,
-    "strictNullChecks": true,
-    "types": [],
-    "jsx": "react",
-    "noEmit": true,
-    "forceConsistentCasingInFileNames": true,
-    "paths": {"react-native": ["."]}
-  },
-  "include": ["**/*.d.ts", "../__typetests__/**/*"]
-}