v5.0.0-beta.0

Major Changes

• #850 9b388e6 Thanks @dohooo!

• 🎯 Support for Expo 54 & Dynamic Sizing

  ✨ Major Features

  Dynamic Sizing Support

  • Auto-sizing: width and height props are now optional. Carousel automatically measures container dimensions via layout

  Expo 54 Compatibility

  • Full support for Expo SDK 54
  • Updated dependencies for latest React Native ecosystem

  💥 Breaking Changes

  Dependencies Update Required

  • react-native-reanimated: Upgrade to ^4.1.0 (was ^3.0.0)
  • react-native-worklets: New peer dependency ^0.5.1 required
  • react-native-gesture-handler: Minimum version ^2.9.0 (no breaking changes)

  Migration Steps

  1. Upgrade Reanimated: npm install react-native-reanimated@^4.1.0
  2. Install Worklets: npm install react-native-worklets@^0.5.1
  3. Follow Reanimated 4.0 migration guide for any breaking changes

  🔧 Technical Improvements

  • Replaced deprecated runOnJS with scheduleOnRN from react-native-worklets
  • Enhanced test coverage for dynamic sizing scenarios
  • Improved overscroll protection logic
  • Better error handling for edge cases

  📚 Documentation

  • Updated installation guide with new dependency requirements
  • Added migration guide from v4 to v5
  • Enhanced examples showcasing dynamic sizing capabilities

  Fixes: #668 - Auto height calculation support

v4.0.3

Patch Changes

• #834 1d2767b Thanks @dohooo! - Add accessibility support to pagination components and replace deprecated TouchableWithoutFeedback with Pressable

  • Add comprehensive accessibility props (accessibilityLabel, accessibilityRole, accessibilityHint, accessibilityState) to both Basic and Custom pagination components
  • Add carouselName prop to allow descriptive accessibility labels
  • Replace TouchableWithoutFeedback with Pressable to remove deprecation warnings
  • Improve screen reader support with proper labeling and state information

  Co-authored-by: AlexJackson01 [email protected]

• #834 1d2767b Thanks @dohooo! - Add comprehensive programmatic control documentation

  • Add new "Programmatic Control" documentation page with detailed examples
  • Clarify that there's no React-style controlled component mode
  • Update migration guide to use correct terminology and link to new docs
  • Provide examples for common use cases: pagination, navigation buttons, dynamic content, auto-advance, and jump-to-item patterns
  • Include warnings about race conditions and timing considerations

• #834 1d2767b Thanks @dohooo! - Replace deprecated TouchableWithoutFeedback with Pressable in pagination components

  Fixes deprecation warnings by replacing TouchableWithoutFeedback with the recommended Pressable component in both Basic and Custom pagination items. This change maintains the same functionality while using the modern React Native API.

  Closes #812

• #834 1d2767b Thanks @dohooo! - Update homepage in package.json

v4.0.2

Patch Changes

• 2b91b7e Thanks @dohooo! - change width breaking the pagination component

v4.0.1

Patch Changes

• 8bfb7b1 Thanks @dohooo! - Configure Babel for React Native Reanimated build

v4.0.0

Major Changes

• #444 56e20c8 Thanks @dohooo! - feat: use new RNGH api

  Updates react-native-gesture-handler to >=2.9.0 and replaces usage of useAnimatedGestureHandler with the new gesture handler API which supports the new gesture handler web implementation.

Minor Changes

• #507 c6d58e5 Thanks @dohooo! - Support to fix the scroll direction through new API, fixedDirection.

Patch Changes

• #687 55c55ff Thanks @dohooo! - feat: Add containerStyle prop to control the container styles.

• d5de105 Thanks @dohooo! - Added missing dependencies for web to work

• #507 353fdce Thanks @dohooo! - remove postinstall script.

• #666 2982fcd Thanks @dohooo! - fix: typescript error where MeasuredDimension can be null

• #677 00c948b Thanks @nmassey! - fix Pagination.Basic and Pagination.Custom usage of TouchableWithoutFeedback.
  This fixes press event handler not working correctly. (Thanks to @qwertychouskie for reporting!)

• #672 5fa78a7 Thanks @dohooo! - revert autoPlay changes

• #600 d9557b2 Thanks @dohooo! - Fixed an issue where endWithSpring used outdated data from useSharedValue after onGestureEnd, causing incorrect carousel behavior on direction reversal.

• 85f24e7 Thanks @dohooo! - Type error property push does not exist on type

• #517 9f3a3d6 Thanks @dohooo! - Reduce the amount of work done when rendering data.

• #496 fdeef6b Thanks @dohooo! - re-calculate when window size changed in browser.

• #597 0d2b930 Thanks @dohooo! - Adds Pagination Component

• #666 32c8c36 Thanks @dohooo! - Add <Pagination.Custom/> dot animation.

• #498 096ac75 Thanks @dohooo! - re-calculate when window size changed in browser. (re-bump for alpha.3)

• #577 17621ca Thanks @nmassey! - fix: make gesture onStart/onUpdate/onEnd (et al) callbacks run as worklets again

• #733 3040863 Thanks @dohooo! - Add pointerEvents: ‘box-none’ to ItemLayout component to allow touches for children components outside item boundaries

• #494 6b849ec Thanks @dohooo! - Removed the reset logic when user change the defaultIndex prop. (We couldn't update the handlerOffset value when user change the defaultIndex. Because the carousel component already be a non-controlled component. So the subsequent changes of defaultIndex will be ignored.)

• #735 848f458 Thanks @dohooo! - This PR updates the customAnimation function signature to include an index parameter, allowing users to apply custom animations based on the item’s index.

• #648 0abdb2d Thanks @nmassey! - fix app crash when using "onProgressChange" prop as function

• #721 2a8111e Thanks @dohooo! - fix: parallax layout with new arch enabled

• #492 978b59f Thanks @dohooo! - feat: change the way of PanGestureHandler modification from panGestureHandlerProps to onConfigurePanGesture.

  e.g.

  <Carousel
    onConfigurePanGesture={(gestureChain) => {
      gestureChain.activeOffsetX([-10, 10]);
    }}
  />

• #528 139d5e5 Thanks @dohooo! - Exported TAnimationStyle types.

• #710 d98bb99 Thanks @nmassey! - fix: remove shared value access warning from react-native-reanimated

• #510 b3cc591 Thanks @dohooo! - Support to specific direction to auto play.

• #703 564d2f5 Thanks @dohooo! - Update homepage in package.json

• #528 b654f43 Thanks @dohooo! - Replaced 'onScrollBegin' with 'onScrollStart' to better match gesture callback.

• 618d90d Thanks @dohooo! - Loss of precision during arithmetic conversion

• #576 a99f069 Thanks @nmassey! - fix: rework code to avoid possible flicker when starting pan (panOffset race condition)

• #724 33022e6 Thanks @dohooo! - fix: next item function overscolling with overscro...

v4.0.0-canary.23

Patch Changes

• d5de105 Thanks @dohooo! - Added missing dependencies for web to work

• 85f24e7 Thanks @dohooo! - Type error property push does not exist on type

• 618d90d Thanks @dohooo! - Loss of precision during arithmetic conversion

v4.0.0-canary.22

Patch Changes

• #735 848f458 Thanks @3000-2
  ! - Updates the customAnimation function signature to include an index parameter, allowing users to apply custom animations based on the item’s index.

v4.0.0-canary.21

Patch Changes

• #733 3040863 Thanks @onghwan! - Add pointerEvents: ‘box-none’ to ItemLayout component to allow touches for children components outside item boundaries

v4.0.0-canary.20

Patch Changes

• #731 6e8cdb4 Thanks @nmassey! - improve "slow pan" behavior: if it seems that the user intent is to stay on the current page (because they didn't pan very far; maybe they started panning one direction then reversed direction, etc.), don't actually change page upon gesture completion

v4.0.0-canary.19

Patch Changes

• #724 33022e6 Thanks @stoickeyboard and @dohooo! - fix: next item function overscolling with overscrollEnabled is false