feat!: Add Expo 54/reanimated 4 support and dynamic sizing capabilities (v5.0.0-beta.1)

[dohooo]

🚀 Major Release: Expo 54/Reanimated 4 Support & Dynamic Sizing (v5.0.0-beta.1)

🎯 Key Features

• 🔥 Dynamic Sizing: width and height props now optional - auto-measures container dimensions
• 📱 Expo 54 Support: Full compatibility with Expo SDK 54
• 🐎 Reanimated 4 Support: Full compatibility with Reanimated 4
• ⚡ Performance: Uses native layout system for accurate measurements

💥 Breaking Changes

• Requires react-native-reanimated@^4.1.0 (was ^3.0.0)
• Requires new peer dependency: react-native-worklets@^0.5.1
• Migration guide provided for smooth upgrade

🐛 Fixes

• No need to specify height prop #668: Auto height calculation support - no more manual dimension calculations!

📦 Installation

npm install react-native-reanimated-carousel@beta
npm install react-native-reanimated@^4.1.0 react-native-worklets@^0.5.1 (Please follow the upgrade instructions from reanimated doc)

Ready for beta testing! Please provide feedback to help stabilize for v5.0.0 stable release.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
react-native-reanimated-carousel	Ready	Preview	Comment	Sep 23, 2025 8:00am

[changeset-bot]

🦋 Changeset detected

Latest commit: 465bece

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
react-native-reanimated-carousel	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[codecov]

Codecov Report

❌ Patch coverage is 60.68966% with 57 lines in your changes missing coverage. Please review.
✅ Project coverage is 76.29%. Comparing base (814f8e3) to head (465bece).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/components/ScrollViewGesture.tsx	32.00%	5 Missing and 12 partials ⚠️
src/hooks/useCarouselController.tsx	65.21%	3 Missing and 5 partials ⚠️
src/hooks/usePropsErrorBoundary.ts	12.50%	4 Missing and 3 partials ⚠️
src/components/CarouselLayout.tsx	73.91%	1 Missing and 5 partials ⚠️
src/hooks/useCommonVariables.ts	80.64%	1 Missing and 5 partials ⚠️
src/components/ItemLayout.tsx	62.50%	0 Missing and 3 partials ⚠️
...rc/components/Pagination/Custom/PaginationItem.tsx	0.00%	3 Missing ⚠️
src/hooks/useInitProps.ts	0.00%	0 Missing and 2 partials ⚠️
src/utils/compute-offset-if-size-changed.ts	0.00%	1 Missing and 1 partial ⚠️
src/hooks/useAutoPlay.ts	85.71%	0 Missing and 1 partial ⚠️
... and 2 more

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #850      +/-   ##
==========================================
- Coverage   78.87%   76.29%   -2.59%     
==========================================
  Files          35       35              
  Lines         819      907      +88     
  Branches      238      286      +48     
==========================================
+ Hits          646      692      +46     
- Misses        116      128      +12     
- Partials       57       87      +30     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.