v3.2.0
amirivojdan/shekarv3.2.0Jun 16, 2026by wingkwong
AI Summary
This update upgrades React Aria to version 1.18.0 and enhances UI components like Calendar, Table, and Autocomplete. It also refactors Radio, Checkbox, and Switch components to use an explicit composition pattern.
Key Highlights
- React Aria 1.18.0 upgrade
- Calendar enhancements (week/day views, multi-select)
- Table SortableColumnHeader export
- Autocomplete Virtualizer
- Explicit composition for Radio, Checkbox, and Switch
Breaking Changes
- Radio, Checkbox, and Switch components moved to explicit *.Content composition; label nesting changed and Description/FieldError became siblings
New Features
- Calendar multi-select and year picker
- Table sortable column headers
- Autocomplete virtualization
- Tooltip delay CSS variables
- Toggle Field composition
Full Release Notes
## What's inside - React Aria 1.18.0 - Calendar → week/day views, multi-select, year picker - Table → SortableColumnHeader - Autocomplete → Virtualizer - Tooltip → delay theme vars - Toggles → new Field composition ## Breaking Changes `Radio`, `Checkbox`, and `Switch` move to an explicit `*.Content` composition — `*.Control` nests inside `*.Content`, the label is plain text inside `*.Content` (no nested `<Label>`), and `Description`/`FieldError` become siblings of `*.Content`. ## What's Changed * fix(docs): broken component links by @wingkwong in https://github.com/heroui-inc/heroui/pull/6577 * chore(docs): add dark mode guide (cn) by @wingkwong in https://github.com/heroui-inc/heroui/pull/6578 * fix(docs): broken redirects by @wingkwong in https://github.com/heroui-inc/heroui/pull/6579 * docs(native): add v1.0.4 release notes and component updates by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6580 * chore(docs): update cn docs for pr6580 & sync missing changes by @wingkwong in https://github.com/heroui-inc/heroui/pull/6581 * fix(toast): defer success/error toast after promise to avoid ViewTransition collision by @aosmcleod in https://github.com/heroui-inc/heroui/pull/6511 * fix(styles): cap modal/alert-dialog scroll-inside height so body scrolls by @wingkwong in https://github.com/heroui-inc/heroui/pull/6597 * fix(fieldset): propagate disabled to descendant RAC by @wingkwong in https://github.com/heroui-inc/heroui/pull/6596 * refactor(table): export Table.SortableColumnHeader by @wingkwong in https://github.com/heroui-inc/heroui/pull/6588 * chore(deps): React Aria Upgrade (v1.18.0) by @wingkwong in https://github.com/heroui-inc/heroui/pull/6586 * fix(scroll-shadow): preserve scrollbar mask by @diegonzs in https://github.com/heroui-inc/heroui/pull/6598 * docs(native): remove figma links from component docs by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6601 * fix(styles): column separator and resizer position in RTL layout by @shlomoi10 in https://github.com/heroui-inc/heroui/pull/6606 * docs(native): add create-heroui-native-app CLI docs and quick-start restructure by @vvv-sss in https://github.com/heroui-inc/heroui/pull/6608 * docs(native): cli release note (cn version) by @wingkwong in https://github.com/heroui-inc/heroui/pull/6610 * Enhance calendar component with new features and documentation by @diegonzs in https://github.com/heroui-inc/heroui/pull/6611 * feat(tooltip): add tooltip delay css vars by @wingkwong in https://github.com/heroui-inc/heroui/pull/6617 * docs(react): add copy prompt in quick install by @wingkwong in https://github.com/heroui-inc/heroui/pull/6609 * refactor(toggles): explicit composition for radio, checkbox & switch by @diegonzs in https://github.com/heroui-inc/heroui/pull/6614 * fix(styles): preserve Select/Autocomplete variant background when isInvalid is set by @mvanhorn in https://github.com/heroui-inc/heroui/pull/6582 * fix: typecheck issues by @wingkwong in https://github.com/heroui-inc/heroui/pull/6623 * fix(toast): align close button position with container padding by @Xuxyyy in https://github.com/heroui-inc/heroui/pull/6574 * fix(styles): inherit font-size from parent instead of forcing text-sm in link by @wingkwong in https://github.com/heroui-inc/heroui/pull/6621 * fix(styles): prevent date-picker calendar popover from being horizontally clipped by @wingkwong in https://github.com/heroui-inc/heroui/pull/6622 * fix(styles): correct secondary header borders in virtualized mode by @wingkwong in https://github.com/heroui-inc/heroui/pull/6624 * fix(docs): preserve NativeComponentsCategory tag in native llms-full.txt by @wingkwong in https://github.com/heroui-inc/heroui/pull/6634 * chore(docs): update Style Fixes for latest merged PRs by @wingkwong in https://github.com/heroui-inc/heroui/pull/6635 * fix(styles): constrain popover size for virtualized ListBox by @wingkwong in https://github.com/heroui-inc/heroui/pull/6642 * refactor(docs): optimization by @wingkwong in https://github.com/heroui-inc/heroui/pull/6630 * fix(autocomplete): popover focus by @wingkwong in https://github.com/heroui-inc/heroui/pull/6627 * fix(tooltip): avoid Focusable warning when mounted inside inert subtree by @wingkwong in https://github.com/heroui-inc/heroui/pull/6628 * fix(spinner): restore animation in non-flex layouts by @wingkwong in https://github.com/heroui-inc/heroui/pull/6644 * fix(styles): browser autofill highlight on grouped input fields by @wingkwong in https://github.com/heroui-inc/heroui/pull/6625 * fix(styles): prevent flex-shrink from collapsing virtualized ListBox scroll height by @wingkwong in https://github.com/heroui-inc/heroui/pull/6636 * V3.2.0 by @wingkwong in https://github.com/heroui-inc/heroui/pull/6616 ## New Contributors * @shlomoi10 made their first contribution in https://github.com/heroui-inc/heroui/pull/6606 * @mvanhorn made their first contribution in https://github.com/heroui-inc/heroui/pull/6582 * @Xuxyyy made their first contribution in https://github.com/heroui-inc/heroui/pull/6574 ## Full Release Note https://heroui.com/docs/react/releases/v3-2-0 **Full Changelog**: https://github.com/heroui-inc/heroui/compare/v3.1.0...v3.2.0