v3.2.0

SylphAI-Inc/AdalFlowv3.2.0Jun 16, 2026by wingkwong

AI Summary

A major update to the UI library featuring React Aria upgrade to v1.18.0, new Calendar capabilities, and a significant refactoring of component compositions.

Key Highlights

  • Upgraded React Aria to version 1.18.0.
  • Calendar component gains week/day views, multi-select, and year picker.
  • Radio, Checkbox, and Switch components moved to explicit `*.Content` composition.
  • Table component now includes `SortableColumnHeader`.
  • Autocomplete component now features a `Virtualizer`.

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`.

New Features

  • Calendar improvements (week/day views, multi-select, year picker)
  • Table sorting capabilities
  • Autocomplete virtualization
  • Tooltip delay CSS variables
  • Toggles 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