Repository navigation
v3.0.0-rc.1
Pre-release
Pre-release
3.0.0-rc.1 (2026-10-14)
⚠ BREAKING CHANGES
- styled-components 6 is required (peer dependency
^6.0.0). With styled-components
5, Wave crashes on import. React 18.2+ and React 19 are supported. - the experimental
Calendarpasses its props on to react-day-picker 10, which
removes the props deprecated in v9. UsestartMonthinstead offromMonthandfromYear,
endMonthinstead oftoMonthandtoYear,hidden={{ before: date }}andhidden={{ after: date }}instead offromDateandtoDate, andautoFocusinstead ofinitialFocus. The
onWeekNumberClick,onDayKeyUp,onDayKeyPress,onDayPointerEnter,onDayPointerLeaveand
onDayTouch*handlers and the deprecatedclassNamesandstyleskeys (e.g.day_selected) are
removed; use customDayButtonandWeekNumbercomponents instead of the handlers. - Tooltip, Popover, Datepicker and the month range picker are positioned by Floating
UI instead of react-popper, with the same placements.react-popper,@popperjs/coreand
wave-react-windowed-selectare no longer installed with Wave, so add them to your own dependencies
if your app imports them. - snapshots of Wave components change: generated class names are shorter
(Box-sc-lqdr92becomes e.g.sc-bdvwhi), component names are e.g.styled.div, vendor prefixes
are gone (passenableVendorPrefixestoStyleSheetManagerto keep them), and Wave props no longer
appear as DOM attributes. Use jest-styled-components 7. - Wave's components no longer set
defaultProps, which React 19 ignores. The default
values are the same, but e.g.Button.defaultPropsisundefined. - the CommonJS build is compiled to ES2015 instead of ES5, like the ES module build.