Christian Falch

This commit **fixes a critical build issue** for external consumers of React Native AARs, such as Expo nightlies. Previously, the `StateWrapper.h` header was missing from the **prefab export list** for the `react/uimanager` module, causing compilation failures when `StateWrapperImpl.h` (which *was* exported) attempted to include it. The **React Native Android build system** is updated to correctly export `src/main/jni/react/uimanager` in the prefab, ensuring all necessary JNI headers are available. This **bug fix** prevents downstream projects from encountering "file not found" errors related to `StateWrapper.h` when consuming published React Native artifacts.

This commit **fixes a critical bug** causing **duplicate symbol errors** when building **React Native iOS applications** that consume **prebuilt `React.XCFramework`s**. Previously, the `RCTSwiftUI.podspec` incorrectly included source files for compilation, leading to symbols being defined both in the prebuilt framework and by direct compilation. The **bug fix** updates the `s.source_files` definition in `packages/react-native/ReactApple/RCTSwiftUI/RCTSwiftUI.podspec` to leverage the `podspec_sources` utility. This ensures only necessary header files are exposed when the `React.XCFramework` is consumed, eliminating runtime conflicts within the **`RCTSwiftUI` module**. This significantly improves the stability and reliability of applications using the prebuilt XCFramework strategy.

This commit delivers a **bug fix** for **iOS precompiled binaries** in React Native, resolving an issue where the `replace-rncore-version.js` script incorrectly deleted the essential `React-VFS.yaml` file. This deletion, occurring when switching between Debug and Release build configurations, led to **build failures** by disrupting **VFS overlay support**. The fix modifies the script's cleanup logic to only remove subdirectories within `ios/Pods/React-Core-prebuilt`, thereby preserving critical files like `React-VFS.yaml`. Additionally, a minor **chore** updates the script name in the `React-Core-prebuilt.podspec` for improved clarity.

This commit **fixes a critical build issue** affecting **Hermes inspector** Debug builds, which previously failed with missing header errors because the `HERMES_V1_ENABLED` compile definition was incorrectly scoped to Release builds only. It **refactors the CMake build system** by centralizing the `HERMES_V1_ENABLED` flag application within the `target_compile_reactnative_options` function in `ReactCommon/cmake-utils/react-native-flags.cmake`. This ensures the flag is consistently applied to all build types for **Hermes modules** and **React Native runtime components**, especially on **Android**. The change prevents build failures, particularly for scenarios like Expo's debugger-enabled builds, and significantly **improves maintainability** by removing redundant conditional logic from multiple `CMakeLists.txt` files.

This commit **fixes a regression in the React Native Android build-from-source process** by re-adding `prefabPublishing = true` to the `hermes-engine` configuration. This change **restores the generation of the CMake config file** required by `find_package(hermes-engine)` in ReactAndroid's native build, which was inadvertently removed when switching to prebuilt Hermes by default. Consequently, it **enables successful compilation of React Native from source on Android**, ensuring developers can build the project without encountering missing CMake configurations. Additionally, this **bug fix** ensures that Hermes build tasks are correctly disabled when not building from source, optimizing CI performance.

This commit introduces **Clang Virtual File System (VFS)** support to **fix** header resolution issues when consuming `React.XCFramework` within React Native iOS projects. A new `vfs.js` module generates `vfs-overlay` files that map header paths, which are then applied via compiler flags by the **CocoaPods integration scripts** (`rncore.rb` and `react_native_pods.rb`) during pod installation. This **enhances the iOS build system's ability** to correctly process modular headers for Objective-C and Swift, resolving conflicts with legacy CocoaPods header structures. The change ensures a more robust and reliable integration of prebuilt `React.XCFramework` components.

This commit **refactors the header file generation process** for **prebuilt React Native XCFrameworks**, replacing a fragile regex-based podspec parsing approach with a more robust, declarative configuration system. It introduces `headers-config.js` to explicitly define header patterns and directories, and **refactors `headers.js`** to leverage this new configuration, supporting nested subspecs and path preservation. Additionally, `xcframework.js` is updated to correctly handle the new header mapping structure, ensuring proper source/target path management during the build. This **enhancement** significantly improves the **reliability and maintainability** of header file collection, making the XCFramework build process more resilient.

This commit performs an **internal refactoring** of the **iOS prebuilding process** by reorganizing the directory structure for header file templates. It moves **umbrella header** and **module map templates**, essential for building **XCFrameworks**, into a new `templates` subdirectory within `packages/react-native/scripts/ios-prebuild`. This **cleanup** updates relevant paths in `xcframework.js` to reflect the new location, improving the organization of build artifacts and scripts without affecting user-facing functionality.

This commit **refactors** the **iOS prebuild system** by updating the `React-umbrella.h` template, changing all header import statements within this **React Native umbrella header** from quoted to angled syntax. This **maintenance change** is a critical prerequisite for enabling future **Virtual File System (VFS) overlays** on iOS. By ensuring the compiler looks up modules correctly, it prepares the **iOS build process** for upcoming architectural improvements and prevents potential compilation issues.

This commit provides a **bug fix** for the **CocoaPods integration script** in React Native, specifically within `packages/react-native/scripts/cocoapods/new_architecture.rb`. It **reorders** the execution of the `add_rncore_dependency` function to occur *after* `spec.pod_target_xcconfig` is assigned. This change prevents the **target `xcconfig` settings** from being inadvertently overwritten, ensuring that configurations applied by `add_rn_core` for **React Native core dependencies** are correctly maintained in **iOS projects** using the **new architecture**. The fix is critical for projects relying on **precompiled binaries** where `xcconfig` modifications are essential.

This commit provides a **bug fix** for **text clipping** on **Android 15+** devices within **React Native's text rendering**. It addresses a behavioral change in Android 15 where `TextView` now defaults to using visual glyph bounds for width calculation, causing text to be cut off for italic or extended typefaces. The solution implements a **two-pass layout strategy** in `TextLayoutManager.kt` specifically for Android 15 and newer, where an initial layout pass determines the true visual width, which is then used for the final layout. This ensures text containers are correctly sized to accommodate full glyph extents, preventing clipping while maintaining backward compatibility and minimizing performance overhead due to existing text measurement caching.

This commit delivers a **bug fix** for the **iOS build process** concerning **symbolication** when utilizing the precompiled `React.XCFramework`. Previously, debugger symbols were incorrectly placed in the root of the framework, preventing Xcode from locating them and hindering debugging. The fix modifies the **CocoaPods integration script** (`rncore.rb`) to correctly copy symbol bundles into their respective slice folders within the `XCFramework`. This **restores proper debugger symbolication**, enabling developers to step into React Native source code when using prebuilt frameworks.

This commit delivers a **bug fix** addressing incorrect source path resolution within the **CocoaPods integration** for **React Native prebuilt frameworks**. Previously, when `RCT_SYMBOLICATE_PREBUILT_FRAMEWORKS` was enabled, dSYM remapping generated erroneous source file paths containing extra segments like `node_modules/node_modules` or an additional `ios/` directory. The fix, located in `packages/react-native/scripts/cocoapods/rncore.rb`, corrects this by expanding the `react_native_path` relative to `Pod::Config.instance.installation_root`. This ensures that paths are resolved accurately, providing proper **dSYM remapping** and improving the reliability of symbolication for prebuilt frameworks.

This commit delivers a **bug fix** addressing **iOS build failures** encountered when using **GNU coreutils**' `cp` command. Previously, a missing `.` in the `cp` command within `packages/react-native/third-party-podspecs/ReactNativeDependencies.podspec` would incorrectly create an extra `Headers` folder, leading to **compilation errors** during the installation of precompiled binaries. The fix adds the necessary `.` to the `cp` command, ensuring correct header file copying and enabling successful builds for developers utilizing GNU coreutils on macOS. This resolves a critical issue impacting the **React Native iOS development workflow**.

This commit provides a **fix** to the **Cocoapods integration** within **React Native's iOS build process**, specifically addressing redundant downloads of `RNDependencies`. It modifies the `react_native_post_install` method in `packages/react-native/scripts/cocoapods/rndependencies.rb` to ensure that after the initial download, the `source` property points to a local file URI for the debug tarball. This change **prevents multiple downloads** of the same dependency, thereby **improving build performance** and efficiency for developers. The update streamlines the `pod install` process when `RCT_USE_RN_DEP=1` is enabled, avoiding unnecessary network requests.

This commit introduces **new capabilities** to the **React Native iOS build process** by adding foundational helper functions for **symbolication of precompiled `React.xcframework`**. Located in `packages/react-native/scripts/cocoapods/rncore.rb`, these functions like `process_dsyms`, `remap_sourcemaps_for_symbols`, and `generate_plist_content` are designed to handle dSYMs, remap source maps, and generate plist content. This **feature enhancement** primarily benefits framework developers, such as Expo, who require deep debugging of React Native's core components. These additions serve as essential "building blocks" that will be utilized in subsequent commits to fully enable symbolication support.

This commit **refactors** and **improves the logging functions** within the **CocoaPods prebuild scripts** for React Native. It **removes unnecessary log statements** from `packages/react-native/scripts/cocoapods/rncore.rb` and `packages/react-native/scripts/cocoapods/rndependencies.rb`, reducing log clutter. Additionally, the `rncore_log` and `rndeps_log` functions are enhanced to provide better formatted and more semantically clear output. This **maintenance** change streamlines the **iOS prebuild process** by making its logs more concise and readable for developers.

This commit introduces a **new capability** to the **iOS build process**, enabling the **symbolication of precompiled React.xcframeworks**. It modifies the `packages/react-native/scripts/cocoapods/rncore.rb` script to download and integrate debug symbols (dSYMs) alongside the prebuilt frameworks. This feature is primarily for **framework developers** who need to debug React Native itself, allowing them to get meaningful stack traces from prebuilt binaries. Users can opt-in to this behavior by setting the `RCT_SYMBOLICATE_PREBUILT_FRAMEWORKS=1` environment variable, which triggers the download and integration of these large symbol files.

This commit introduces a **fix** for **CocoaPods integration** on **iOS**, specifically addressing build issues when using **precompiled binaries** in conjunction with the `USE_FRAMEWORKS` flag for both static and dynamic linkage. It centralizes framework configuration logic by adding a new helper method, `resolve_use_frameworks`, to `packages/react-native/scripts/cocoapods/utils.rb` and `packages/react-native/scripts/react_native_pods.rb`. This method ensures correct header search paths and module definitions, particularly for the `ReactCodegen` module, which previously failed to locate its generated files in such build configurations. The change updates numerous **React Native core module `.podspec` files** to utilize this new helper, resolving build failures and improving the robustness of framework-based builds.

This commit provides a **critical bug fix** for **iOS builds** to ensure **compatibility with Xcode 26**. It addresses a breaking change where Xcode 26's default enablement of explicit Swift modules (`SWIFT_ENABLE_EXPLICIT_MODULES`) caused build failures when using **precompiled React Native binaries**. The change modifies the `react_native_pods.rb` script to conditionally **disable explicit Swift modules** in this specific scenario. This update is essential for developers to successfully build and run **React Native applications** on the latest Xcode version without encountering compilation errors.