Repository navigation
5.0.0 (2026-10-27)
⚠ BREAKING CHANGES
Peer dependencies
@gravity-ui/uikit ^8.0.0 is required, uikit v7 is not supported. React and React DOM have to be 18 or 19. @types/react is optional now: in 4.x a typo made it required. No optional peers of uikit are needed.
Language is set on Provider
ThemeProvider no longer accepts lang. Move lang to Provider or LangProvider. TypeScript reports a leftover lang, but plain JavaScript ignores it, and the components fall back to English.
Timezone list is not virtualized
The timezone list of RelativeRangeDatePicker (withZonesList) renders all ~420 options, and uikit logs a console.error in development. To keep it virtualized, install @tanstack/react-virtual and wrap the application in <ListVirtualizer minItemsCount={50}> from @gravity-ui/uikit/virtualizer.
hasDate and hasTime are removed
DatePickerState and RangeDatePickerState no longer have the deprecated hasDate and hasTime. Use state.formatInfo.hasDate and state.formatInfo.hasTime.
Props hooks return uikit v8 props
useDatePickerProps, useRelativeDatePickerProps, useRelativeDateFieldProps, useDateFieldProps and useCalendarProps return props for the uikit v8 components. popupProps has no onEscapeKeyDown and onOutsideClick: dismissal comes through onOpenChange(open, event, reason). If you only spread these props, nothing changes.
RelativeRangeDatePickerDialog on mobile
If you render the dialog yourself: the sheet is controlled by open, onClose is called once with the real reason ('escape-key', 'outside-press', 'swipe' or 'navigation') as soon as the sheet starts to close, and onRemove is called after the closing animation. In 4.x applying a value called onClose twice.
Pickers inside Dialog and Modal
A uikit v8 Dialog moves focus to its content about 150ms after mount. A picker focused earlier, for example in a fast test, loses focus, and its popup closes. In tests, wait until the dialog has focus.
Visual changes
Colors come from Themer v2, the hover styles of uikit components apply only on devices that can hover, and the presets and timezone lists of RelativeRangeDatePicker look like the uikit v8 List and Select. Update screenshot baselines and CSS overrides of uikit classes.