Changelog

Added

• Gallery: Switching to grid, its cells fade in outward from the centre on the transition's delay, like transition={{ arrange: { delay: stagger(0.05) } }}.
• Gallery: The detail strip's stagger takes stagger()'s from, so transition={{ close: { delay: stagger(0.04, { from: "last" }) } }} closes it from the outside in.

Changed

• Gallery: Opening detail fades the whole strip in as one staggered wave, both sides of the open item together.
• Gallery: An item that changes places without flying there moves with its neighbours as it fades.

Fixed

• Gallery: Items gather behind the active one again when switching to grid.
• Gallery: New options of the same arrangement, like a ring's rotateX, blend its camera as one piece again.
• Gallery: Switching away from grid after paging no longer flies the previously active item off alone, or others in from where they were last drawn.
• Gallery: Closing detail just after a change no longer flies the previously open item out of the strip.

Fixed

• Gallery: Closing detail fades the whole strip out together. Thumbnails with no place in view to return to no longer linger.
• Gallery: Paging on straight after switching to grid no longer hides the item paged to.
• Gallery: Switching away from grid no longer resizes its items to the next arrangement's item size as they fade out.

Added

• Gallery: rearrange option and shift() preset set the state an item fades in from when it changes places without flying there.
• Gallery: rearrangeFrom option sets where the stagger starts as the detail strip opens or closes.
• Gallery: gather option. Items collapse behind the active one when switching to grid.

Fixed

• Gallery: Items no longer fly across the view when loop or arrange changes. They fade out and in on the side they belong.
• Gallery: Opening and closing detail fades the other items between the arrangement and the strip.
• Gallery: The camera no longer swings between arrangements, so items entering the new one fade in where they belong.

Added

• Gallery: 2D and 3D gallery animations with list and detail view.

Changed

• Requires motion@^14.1.0.
• Improved tree shaking.

Removed

• animateLayout moved to motion.

Changed

• Requires motion@^13.0.0.
• motion is now a peer dependency of motion-plus and motion-plus-dom, so it must be explicitly installed alongside them.

Added

• curtains/useCurtains: Cover/reveal page and element transitions.

Fixed

• AnimateNumber: Ensure values are updated when only§ suffix/prefix update.

Fixed

• splitText: Ensure split text elements retain vertical positioning.
• Carousel: Fix focus from breaking item reprojection.

Fixed

• Ticker: Improve accessibility attributes.
• Cursor: Fix when using with browser-native drag gestures.
• Updating ref type inference for Typewriter, Ticker and ScrambleText.

Added

• Carousel: New wheelSwipeThreshold prop configures the distance of wheel scroll before triggering a swipe.

Added

• AnimateNumber: trend prop to control digit spin direction. - trend={1}: Digits always spin upward, wrapping 9 → 0. - trend={-1}: Digits always spin downward, wrapping 0 → 9. - trend={(oldValue, newValue) => number}: Function for custom logic. - Default (no trend): Auto-detects direction based on value change.

Changed

• AnimateNumber: Now uses manual FLIP measurements instead of layout animations.

Added

• useCarousel and useTicker: Provides offset motion value, which contains the unwrapped offset of a Carousel or Ticker.

Added

• AnimateView: View animations for React.

Changed

• ScrambleText: Removing span.

Fixed

• scrambleText: Fixed delay handling.

Added

• scrambleText: Now supports string MotionValue.

Added

• Typewriter: onChange callback.

Fixed

• ScrambleText: Switch from useEffect to useLayoutEffect.

Fixed

• scrambleText and ScrambleText: Default duration is now 1.

Added

• scrambleText and ScrambleText: Added scramble text for vanilla JS and React.

Added

• Typewriter: Added cursorBlinkRepeat option for capping the number of times a cursor blinks after typing stops.

Added

• splitText: Added preserveHyphens option.

Fixed

• Carousel: Removing pageTransition from generated types - use transition instead.

Added

• animateLayout: Vanilla layout animations.

Added

• Carousel: Added page prop for controlling the current page via props.

Added

• UMD bundle now published via GitHub.

Fixed

• Carousel: Ensure only on-axis wheel scrolls prevent native browser scrolling.

Fixed

• Carousel: Improved handling of pointer and wheel events in item gaps.

Added

• Carousel: Create accessible, performant, infinitely-scrolling carousels.
• useTickerItem: Access item-relative offset within Carousel and Ticker, as well as item information like itemIndex, cloneIndex, layout start and end.
• Ticker: Added fade and safeMargin options.

Removed

• useItemOffset. Replace const offset = useItemOffset() with const { offset } = useTickerItem().

Added

• Ticker: RTL support.

Changed

• Typewriter: Adjusted natural typing variance calculations.