feat(iOS): normalizing html (#435)

# Summary

Integrates
[gumbo-parser](https://codeberg.org/gumbo-parser/gumbo-parser) to
normalize external HTML (Google Docs, Word, web pages) into the
canonical tag subset our enriched parser understands.

If an unsupported tag is encountered (for example: `<table>`), it will
be omitted while preserving and keeping its text content.
Nested structures will be flattened where necessary to match the
constraints of the enriched format.

### Changes

- Added `gumbo-parser.h` amalgamation header
- Implemented `gumbo_normalizer.c` — converts arbitrary HTML into
canonical tags (`<b>`, `<i>`, `<u>`, `<s>`, `<p>`, `<br>`, lists,
headings, etc.)
- iOS: integrated through podspec, used in `InputParser.mm`
- Controlled by `useHtmlNormalizer` prop (off by default)
- Added [gtest](https://google.github.io/googletest/) and
`GumboParserTest.cpp` test suite covering tag remapping, span styles,
tables, lists

## Test Plan
1. Run example app
2. Try to paste rich content from google docs, slack, gmail
3. Pasted rich content should look the same like in external app

## Screenshots / Videos



https://github.com/user-attachments/assets/ae37561d-31f6-45f5-9c07-9e6e23f723cb



## Compatibility

| OS      | Implemented |
| ------- | :---------: |
| iOS     |    ✅    |
| Android |    ❌     |

---------

Author: kacperzolkiewski

ReactNativeEnriched.podspec

@@ -13,8 +13,12 @@ Pod::Spec.new do |s|
   s.platforms    = { :ios => min_ios_version_supported }
   s.source       = { :git => "https://github.com/software-mansion/react-native-enriched.git", :tag => "#{s.version}" }
 
-  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.source_files = ["ios/**/*.{h,m,mm,cpp}", "cpp/**/*.{h,hpp,c,cpp}"]
+  s.exclude_files = ["cpp/tests/**"]
   s.private_header_files = "ios/**/*.h"
+  s.pod_target_xcconfig = {
+    'HEADER_SEARCH_PATHS' => '"${PODS_TARGET_SRCROOT}/cpp/parser" "${PODS_TARGET_SRCROOT}/cpp/GumboParser"'
+  }
 
 # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
 # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.

android/src/main/java/com/swmansion/enriched/textinput/EnrichedTextInputViewManager.kt

@@ -272,6 +272,13 @@ class EnrichedTextInputViewManager :
     // no-op
   }
 
+  override fun setUseHtmlNormalizer(
+    view: EnrichedTextInputView?,
+    value: Boolean,
+  ) {
+    // no-op
+  }
+
   override fun focus(view: EnrichedTextInputView?) {
     view?.requestFocusProgrammatically()
   }

apps/example/ios/Podfile.lock

@@ -2064,7 +2064,7 @@ EXTERNAL SOURCES:
 
 SPEC CHECKSUMS:
   FBLazyVector: c12d2108050e27952983d565a232f6f7b1ad5e69
-  hermes-engine: 57506c1404e8b80c5386de18743e0d02c8d4f681
+  hermes-engine: e5ffaed830497fff782ee4c30c3f8ea61123bf13
   RCTDeprecation: 3280799c14232a56e5a44f92981a8ee33bc69fd9
   RCTRequired: 9854a51b0f65ccf43ea0b744df4d70fce339db32
   RCTSwiftUI: 96986e49a4fdc2c2103929dee2641e1b57edf33d
@@ -2073,7 +2073,7 @@ SPEC CHECKSUMS:
   React: 7ef36630d07638043a134a7dd2ec17e0be10fc3c
   React-callinvoker: af4e8fe1d60ab63dd8d74c2a68988064c2848954
   React-Core: c0fb1df65eb0ed7a8633841831f05f93c3eb3aff
-  React-Core-prebuilt: cd92350bf2041dde22a9bc0b8984d9c70d179ca1
+  React-Core-prebuilt: 65fb7126c1a54707eac825da605bd09a5a6ec76a
   React-CoreModules: 7dfe7962360355f1547c85ab52e1fc4b57f17127
   React-cxxreact: 9e9c7f1710bc58abebf924813b5e825b99adb8e5
   React-debug: 38389b86e3570558ec73dd4cbc0cd2f2eec47a51
@@ -2135,8 +2135,8 @@ SPEC CHECKSUMS:
   ReactAppDependencyProvider: 625d2f6d9d5ef01acc9dfe2b5385504bbffd2ad0
   ReactCodegen: 27937747ddc743fcb66a8dc19e8edf60188d94cc
   ReactCommon: cc0e38600f82487c5fe5d29150abb6fa9d981986
-  ReactNativeDependencies: cebf665879bab2908201494cc5a9760dbdf0a637
-  ReactNativeEnriched: cea43cfd577befb70d99a8dde914004625a9a9d0
+  ReactNativeDependencies: d49d9d865b7eb4a9884164a4b6f50440edb37e01
+  ReactNativeEnriched: 955ecbffda0ae4e899dcec807fb4f9c0d1fa04e0
   Yoga: 772166513f9cd2d61a6251d0dacbbfaa5b537479
 
 PODFILE CHECKSUM: 88c10840d02e9884b2dc3f457d5120f83ac3803b

apps/example/src/App.tsx

@@ -348,6 +348,7 @@ export default function App() {
               ANDROID_EXPERIMENTAL_SYNCHRONOUS_EVENTS
             }
             onPasteImages={(e) => handlePasteImagesEvent(e.nativeEvent)}
+            useHtmlNormalizer
           />
           <Toolbar
             stylesState={stylesState}

cpp/CMakeLists.txt

@@ -0,0 +1,50 @@
+cmake_minimum_required(VERSION 3.14)
+project(gumbo_parser_tests C CXX)
+
+# ── Fetch Google Test ────────────────────────────────────────────────────────
+include(FetchContent)
+FetchContent_Declare(
+    googletest
+    GIT_REPOSITORY https://github.com/google/googletest.git
+    GIT_TAG        v1.17.0
+)
+# For Windows: Prevent overriding the parent project's compiler/linker settings
+set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
+FetchContent_MakeAvailable(googletest)
+
+# ── Shared library: gumbo normalizer + C++ wrapper ──────────────────────────
+add_library(gumbo_normalizer_lib SHARED
+    parser/GumboNormalizer.c
+    parser/GumboParser.cpp
+)
+
+target_include_directories(gumbo_normalizer_lib PUBLIC
+    ${CMAKE_CURRENT_SOURCE_DIR}/GumboParser
+    ${CMAKE_CURRENT_SOURCE_DIR}/parser
+)
+
+# Compile the C file as C99, C++ files as C++17
+set_source_files_properties(
+    parser/GumboNormalizer.c
+    PROPERTIES LANGUAGE C
+               COMPILE_FLAGS "-std=c99"
+)
+
+target_compile_options(gumbo_normalizer_lib PRIVATE
+    $<$<COMPILE_LANGUAGE:CXX>:-std=c++17>
+)
+
+# ── Test executable ──────────────────────────────────────────────────────────
+enable_testing()
+
+add_executable(gumbo_parser_tests
+    tests/GumboParserTest.cpp
+)
+
+target_link_libraries(gumbo_parser_tests PRIVATE
+    gumbo_normalizer_lib
+    GTest::gtest_main
+)
+
+include(GoogleTest)
+gtest_discover_tests(gumbo_parser_tests)