fix: align codegen contract across native and JS (audit PR 4/6)

[sbaiahmed1]

Part 4 of 6 in the July 2026 audit remediation. Stacked on fix/ios-pr3-lifecycle.

Codegen contract alignment across native and JS.

• AND-03 BlurSwitchManager adopts the generated codegen delegate (props flow through codegen like the other two managers).
• AND-04 unify the blurAmount→radius mapping. Per maintainer decision the two blur views keep their current 1:1 strength and BlurSwitch is brought up to match (no rendering change for the blur views); misleading "0-25" comments removed.
• AND-05 native blurRounds default set to 5 (single source of truth).
• TS-03 ignoreSafeArea JSDoc/default fixes; TS-07 spacing WithDefault + missing default exports; IOS-NEW-4 progressive init compares the correct default.

Deferred by decision: TS-NEW-1 (ColorValue-typed colour props).

Verified: Android + iOS build; tsc clean; the switch renders + toggles through the new delegate.

Summary by CodeRabbit

• New Features

  • Increased maximum blur intensity for Android blur switches.
  • Added default imports for LiquidGlassContainer and VibrancyView.
  • Added a default spacing value of 0 for liquid glass containers.

• Bug Fixes

  • Improved blur behavior and default blur-round consistency across platforms.
  • Corrected iOS initial blur-type handling.
  • Updated inaccurate safe-area documentation and prop defaults.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5be77995-1a8c-42ef-854b-071d8d1ea353

📥 Commits

Reviewing files that changed from the base of the PR and between 7185545 and 8e56b17.

📒 Files selected for processing (10)

• android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeBlurSwitch.kt
• android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeBlurSwitchManager.kt
• android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeBlurView.kt
• android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeProgressiveBlurView.kt
• ios/ReactNativeProgressiveBlurView.mm
• src/BlurView.tsx
• src/LiquidGlassContainer.tsx
• src/LiquidGlassView.tsx
• src/ReactNativeLiquidGlassContainerNativeComponent.ts
• src/VibrancyView.tsx

---

📝 Walkthrough

Walkthrough

Changes

The Android blur pipeline now uses 0–100 radius mapping and five default blur rounds, with switch manager delegation updates. iOS initialization recognizes Regular as the default blur type. TypeScript components gain default exports, corrected documentation, and a default spacing value.

Android blur and delegation

Layer / File(s)	Summary
Switch manager delegation android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeBlurSwitchManager.kt	Adds ViewManagerDelegate wiring, interface overrides, and removes the explicit blurAmount annotation default.
Blur mapping and defaults android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeBlurSwitch.kt, android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeBlurView.kt, android/src/main/java/com/sbaiahmed1/reactnativeblur/ReactNativeProgressiveBlurView.kt	Expands blur radius mapping to 0–100, changes default blur rounds from 3 to 5, and updates related documentation and logging.

iOS blur initialization

Layer / File(s)	Summary
Default blur type handling ios/ReactNativeProgressiveBlurView.mm	Uses Regular when deciding whether the initial blur type update is needed.

TypeScript component API

Layer / File(s)	Summary
Exports, codegen defaults, and documentation src/ReactNativeLiquidGlassContainerNativeComponent.ts, src/LiquidGlassContainer.tsx, src/VibrancyView.tsx, src/BlurView.tsx, src/LiquidGlassView.tsx	Adds default exports, gives spacing a codegen default of 0, and corrects ignoreSafeArea documentation.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

• sbaiahmed1/react-native-blur#61: Overlaps with Android blur-radius mapping and progressive blur configuration changes.
• sbaiahmed1/react-native-blur#72: Introduced the Android switch implementation updated by this PR.
• sbaiahmed1/react-native-blur#92: Overlaps with the Android default blur rounds changing from 3 to 5.

Suggested reviewers: danielaraldi

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/pr4-codegen-contract

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed. For unrecoverable errors, disable the tool in CodeRabbit configuration.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}