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

package/scripts/spm/sync-spm-autolinking.js

@@ -0,0 +1,160 @@
+/**
+ * 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';
+
+/**
+ * sync-spm-autolinking.js – Lightweight script invoked by the Xcode pre-build
+ * phase to re-run invariant codegen and autolinking output when dependency
+ * inputs have changed.
+ *
+ * Usage (called from the Xcode build phase shell script):
+ *   node sync-spm-autolinking.js --app-root <path> --react-native-root <path>
+ *
+ * The autolinking config (autolinking.json) is generated by the caller
+ * (setup-apple-spm.js) BEFORE this script runs, so codegen below can reuse it
+ * (findCodegenEnabledLibraries short-circuits on a present autolinking.json)
+ * and the slow `@react-native-community/cli config` runs exactly once per sync.
+ *
+ * This script:
+ *   0. Runs react-native codegen → build/generated/ios/ (reuses autolinking.json)
+ *   1. Installs the codegen template into build/generated/ios/Package.swift,
+ *      replacing codegen's mis-rooted default (done immediately, before any
+ *      step below that can throw — see the failure-atomicity comment at the
+ *      call site)
+ *   2. Calls generate-spm-autolinking.js → build/generated/autolinking/Package.swift
+ *   3. Rebuilds the generated-headers farm
+ *   4. Writes build/generated/autolinking/.spm-sync-stamp
+ *
+ * Runtime frameworks are deliberately not downloaded or regenerated from an
+ * Xcode build. `spm add` / `spm update` own the immutable dual-flavor slots and
+ * the app target's linker/embed configuration.
+ */
+
+const {main: generateAutolinking} = require('./generate-spm-autolinking');
+const {
+  RemoteVersionError,
+  buildPerAppHeaderTree,
+  findProjectRoot,
+  installSpmCodegenTemplate,
+  makeLogger,
+  runCodegenAndInstallTemplate,
+} = require('./spm-utils');
+const fs = require('fs');
+const path = require('path');
+const yargs = require('yargs');
+
+const {log} = makeLogger('sync-spm-autolinking');
+
+// Collaborators are injected (with these real implementations as defaults) so
+// main() can be exercised end-to-end in tests without mocking the module
+// system. Tests pass fakes that record calls and point defaultCacheDir at a
+// tempdir; everything fs-based runs for real against that tempdir.
+const defaultDeps = {
+  runCodegenAndInstallTemplate,
+  generateAutolinking,
+  installSpmCodegenTemplate,
+  buildPerAppHeaderTree,
+  findProjectRoot,
+};
+
+async function main(
+  argv /*:: ?: Array<string> */,
+  overrides /*:: ?: Partial<typeof defaultDeps> */,
+) /*: Promise<void> */ {
+  const deps = {...defaultDeps, ...(overrides ?? {})};
+  const parsed = yargs(argv ?? process.argv.slice(2))
+    .version(false)
+    .option('app-root', {
+      type: 'string',
+      demandOption: true,
+      describe: 'Path to the app directory',
+    })
+    .option('react-native-root', {
+      type: 'string',
+      demandOption: true,
+      describe: 'Path to react-native package root',
+    })
+    .help()
+    .parseSync();
+
+  const appRoot = path.resolve(parsed['app-root']);
+  const reactNativeRoot = path.resolve(parsed['react-native-root']);
+  const projectRoot = deps.findProjectRoot(appRoot);
+
+  // The caller (setup-apple-spm.js) already generated autolinking.json before
+  // invoking this script, so codegen reuses it here.
+  try {
+    deps.runCodegenAndInstallTemplate(
+      projectRoot,
+      appRoot,
+      reactNativeRoot,
+      {log},
+      {
+        installTemplate: false,
+      },
+    );
+  } catch {
+    log('Codegen failed — continuing with existing output');
+  }
+
+  // Install the codegen template right away, before artifact download and
+  // autolinking-plugin execution below. Failure-atomicity: generateAutolinking
+  // runs fail-closed plugins that can throw, and if that happens before the
+  // template is installed, codegen's mis-rooted default manifest is left in
+  // build/generated/ios/Package.swift — breaking every subsequent Xcode
+  // "Resolve Package Graph". Installing it immediately after codegen means a
+  // later throw can never leave that broken manifest in place.
+  deps.installSpmCodegenTemplate(appRoot, reactNativeRoot, {log});
+
+  log('Re-generating build/generated/autolinking/Package.swift...');
+  deps.generateAutolinking([
+    '--app-root',
+    appRoot,
+    '--react-native-root',
+    reactNativeRoot,
+  ]);
+
+  // Rebuild the per-app generated-headers farm (vended as the ReactAppHeaders
+  // SPM target inside the codegen package). React core headers need no trees
+  // — they are vended by the invariant ReactHeaders/ReactNativeHeaders products.
+  // The
+  // generated manifests are fully declarative (fixed-relative package paths),
+  // so no path-locator JSON is written.
+  deps.buildPerAppHeaderTree(appRoot, {log});
+
+  const stampPath = path.join(
+    appRoot,
+    'build',
+    'generated',
+    'autolinking',
+    '.spm-sync-stamp',
+  );
+  fs.mkdirSync(path.dirname(stampPath), {recursive: true});
+  fs.writeFileSync(stampPath, new Date().toISOString() + '\n', 'utf8');
+  log('SPM autolinking sync complete.');
+}
+
+if (require.main === module) {
+  main().catch(e => {
+    if (e instanceof RemoteVersionError) {
+      // Clean message + exit 2 (the build phase hard-fails on it) instead of a
+      // stack trace, matching how setup-apple-spm.js surfaces remote-mode
+      // version errors.
+      log(e.message);
+      process.exitCode = 2;
+      return;
+    }
+    console.error(e);
+    process.exitCode = 1;
+  });
+}
+
+module.exports = {main};

package/sdks/.hermesv1version

@@ -0,0 +1 @@
+hermes-v250829098.0.16

package/sdks/hermes-engine/utils/replace_hermes_version.js

@@ -14,7 +14,7 @@ const {spawnSync} = require('child_process');
 const fs = require('fs');
 const yargs = require('yargs');
 
-const LAST_BUILD_FILENAME = '.last_build_configuration';
+const LAST_BUILD_FILENAME = 'hermes-engine/.last_build_configuration';
 
 function validateBuildConfiguration(configuration) {
   if (!['Debug', 'Release'].includes(configuration)) {
@@ -56,15 +56,29 @@ function shouldReplaceHermesConfiguration(configuration) {
 function replaceHermesConfiguration(configuration, version, podsRoot) {
   const tarballURLPath = `${podsRoot}/hermes-engine-artifacts/hermes-ios-${version.toLowerCase()}-${configuration.toLowerCase()}.tar.gz`;
 
+  if (!fs.existsSync(tarballURLPath)) {
+    throw new Error(`Hermes tarball not found at ${tarballURLPath}`);
+  }
+
   const finalLocation = 'hermes-engine';
   console.log('Preparing the final location');
   fs.rmSync(finalLocation, {force: true, recursive: true});
   fs.mkdirSync(finalLocation, {recursive: true});
 
   console.log('Extracting the tarball');
-  spawnSync('tar', ['-xf', tarballURLPath, '-C', finalLocation], {
-    stdio: 'inherit',
-  });
+  const result = spawnSync(
+    'tar',
+    ['-xf', tarballURLPath, '-C', finalLocation],
+    {
+      stdio: 'inherit',
+    },
+  );
+  if (result.status !== 0) {
+    fs.rmSync(finalLocation, {force: true, recursive: true});
+    throw new Error(
+      `Failed to extract ${tarballURLPath}: ${result.error?.message ?? `tar exited with status ${result.status}`}`,
+    );
+  }
 }
 
 function updateLastBuildConfiguration(configuration) {

package/sdks/hermes-engine/version.properties

@@ -1 +1 @@
-HERMES_VERSION_NAME=250829098.0.13
+HERMES_VERSION_NAME=250829098.0.16

package/src/asset-registry.js

@@ -11,7 +11,7 @@
 'use strict';
 
 // ----------------------------------------------------------------------------
-// Secondary react-native/asset-registry entry point.
+// react-native/asset-registry
 //
 // This is an untyped secondary entry point intended to be referenced from
 // Metro's `transformer.assetRegistryPath` config option. This entry point may

package/src/react-private-interface.js

@@ -0,0 +1,145 @@
+/**
+ * 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';
+
+// ----------------------------------------------------------------------------
+// react-native/react-private-interface
+//
+// This is a private entry point allowing React to require React Native
+// internals (previously, Libaries/ReactNativePrivateInterface.js).
+//
+// These APIs should ONLY be used by first party React internals and are not
+// part of our public API.
+//
+// IMPORTANT: Keep this file in sync with react-private-interface.js.flow.
+// ----------------------------------------------------------------------------
+
+import typeof BatchedBridge from '../Libraries/BatchedBridge/BatchedBridge';
+import typeof legacySendAccessibilityEvent from '../Libraries/Components/AccessibilityInfo/legacySendAccessibilityEvent';
+import typeof TextInputState from '../Libraries/Components/TextInput/TextInputState';
+import typeof ExceptionsManager from '../Libraries/Core/ExceptionsManager';
+import typeof RawEventEmitter from '../Libraries/Core/RawEventEmitter';
+import typeof ReactFiberErrorDialog from '../Libraries/Core/ReactFiberErrorDialog';
+import typeof RCTEventEmitter from '../Libraries/EventEmitter/RCTEventEmitter';
+import typeof {
+  createPublicInstance,
+  createPublicRootInstance,
+  createPublicTextInstance,
+  getInternalInstanceHandleFromPublicInstance,
+  getNativeTagFromPublicInstance,
+  getNodeFromPublicInstance,
+} from '../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance';
+import typeof {
+  create as createAttributePayload,
+  diff as diffAttributePayloads,
+} from '../Libraries/ReactNative/ReactFabricPublicInstance/ReactNativeAttributePayload';
+import typeof UIManager from '../Libraries/ReactNative/UIManager';
+import typeof * as ReactNativeViewConfigRegistry from '../Libraries/Renderer/shims/ReactNativeViewConfigRegistry';
+import typeof flattenStyle from '../Libraries/StyleSheet/flattenStyle';
+import type {DangerouslyImpreciseStyleProp} from '../Libraries/StyleSheet/StyleSheet';
+import typeof deepFreezeAndThrowOnMutationInDev from '../Libraries/Utilities/deepFreezeAndThrowOnMutationInDev';
+import typeof deepDiffer from '../Libraries/Utilities/differ/deepDiffer';
+import typeof Platform from '../Libraries/Utilities/Platform';
+import typeof dispatchNativeEvent from './private/renderer/events/dispatchNativeEvent';
+import typeof CustomEvent from './private/webapis/dom/events/CustomEvent';
+
+export type {PublicRootInstance} from '../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance';
+export type PublicTextInstance = ReturnType<createPublicTextInstance>;
+
+// flowlint unsafe-getters-setters:off
+// eslint-disable-next-line @react-native/monorepo/no-commonjs-exports
+module.exports = {
+  get BatchedBridge(): BatchedBridge {
+    return require('../Libraries/BatchedBridge/BatchedBridge').default;
+  },
+  get ExceptionsManager(): ExceptionsManager {
+    return require('../Libraries/Core/ExceptionsManager').default;
+  },
+  get Platform(): Platform {
+    return require('../Libraries/Utilities/Platform').default;
+  },
+  get RCTEventEmitter(): RCTEventEmitter {
+    return require('../Libraries/EventEmitter/RCTEventEmitter').default;
+  },
+  get ReactNativeViewConfigRegistry(): ReactNativeViewConfigRegistry {
+    return require('../Libraries/Renderer/shims/ReactNativeViewConfigRegistry');
+  },
+  get TextInputState(): TextInputState {
+    return require('../Libraries/Components/TextInput/TextInputState').default;
+  },
+  get UIManager(): UIManager {
+    return require('../Libraries/ReactNative/UIManager').default;
+  },
+  // TODO: Remove when React has migrated to `createAttributePayload` and `diffAttributePayloads`
+  get deepDiffer(): deepDiffer {
+    return require('../Libraries/Utilities/differ/deepDiffer').default;
+  },
+  get deepFreezeAndThrowOnMutationInDev(): deepFreezeAndThrowOnMutationInDev<
+    {...} | Array<unknown>,
+  > {
+    return require('../Libraries/Utilities/deepFreezeAndThrowOnMutationInDev')
+      .default;
+  },
+  // TODO: Remove when React has migrated to `createAttributePayload` and `diffAttributePayloads`
+  get flattenStyle(): flattenStyle<DangerouslyImpreciseStyleProp> {
+    // $FlowFixMe[underconstrained-implicit-instantiation]
+    // $FlowFixMe[incompatible-type]
+    return require('../Libraries/StyleSheet/flattenStyle').default;
+  },
+  get ReactFiberErrorDialog(): ReactFiberErrorDialog {
+    return require('../Libraries/Core/ReactFiberErrorDialog').default;
+  },
+  get legacySendAccessibilityEvent(): legacySendAccessibilityEvent {
+    return require('../Libraries/Components/AccessibilityInfo/legacySendAccessibilityEvent')
+      .default;
+  },
+  get RawEventEmitter(): RawEventEmitter {
+    return require('../Libraries/Core/RawEventEmitter').default;
+  },
+  get CustomEvent(): CustomEvent {
+    return require('./private/webapis/dom/events/CustomEvent').default;
+  },
+  get createAttributePayload(): createAttributePayload {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactNativeAttributePayload')
+      .create;
+  },
+  get diffAttributePayloads(): diffAttributePayloads {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactNativeAttributePayload')
+      .diff;
+  },
+  get createPublicRootInstance(): createPublicRootInstance {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance')
+      .createPublicRootInstance;
+  },
+  get createPublicInstance(): createPublicInstance {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance')
+      .createPublicInstance;
+  },
+  get createPublicTextInstance(): createPublicTextInstance {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance')
+      .createPublicTextInstance;
+  },
+  get getNativeTagFromPublicInstance(): getNativeTagFromPublicInstance {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance')
+      .getNativeTagFromPublicInstance;
+  },
+  get getNodeFromPublicInstance(): getNodeFromPublicInstance {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance')
+      .getNodeFromPublicInstance;
+  },
+  get getInternalInstanceHandleFromPublicInstance(): getInternalInstanceHandleFromPublicInstance {
+    return require('../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance')
+      .getInternalInstanceHandleFromPublicInstance;
+  },
+  get dispatchNativeEvent(): dispatchNativeEvent {
+    return require('./private/renderer/events/dispatchNativeEvent').default;
+  },
+};

package/src/react-private-interface.js.flow

@@ -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 strict-local
+ * @format
+ */
+
+// ----------------------------------------------------------------------------
+// Types entry point for react-native/react-private-interface
+//
+// IMPORTANT: Keep this file in sync with react-private-interface.js.
+// ----------------------------------------------------------------------------
+
+import typeof {createPublicTextInstance as createPublicTextInstanceT} from '../Libraries/ReactNative/ReactFabricPublicInstance/ReactFabricPublicInstance';
+
+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/src/setup-env.js

@@ -0,0 +1,22 @@
+/**
+ * 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';
+'use client';
+
+// ----------------------------------------------------------------------------
+// react-native/setup-env
+//
+// Side-effectful module that sets up the core React Native JavaScript
+// environment. This includes global timers (`setTimeout` etc), the global
+// `console` object, and hooks for printing stack traces with source maps.
+// ----------------------------------------------------------------------------
+
+require('./private/setup/setUpDefaultReactNativeEnvironment').default();

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