Release v1.3.0

[b1ink0]

New Components

Component	Description	Related PRs
DurationInput	Hours input combining a drag slider and a text field.	#234, #281, #306, #334, #335
Filter	Filter condition builder.	#226, #238, #274, #275, #297, #299, #300, #301, #302, #308, #311
StaticTextEditor	Read-only TipTap renderer.	#271, #312, #324

Components Rebuilt on Base UI

Component	Migrated in	Follow-up PRs
Select	#220	#278, #325, #328, #354
AutoComplete	#256	#259, #343
Combobox	#254	#307, #333, #355
DatePicker	#236	#283, #285, #332, #354
DateRangePicker	#236	#247, #283, #285, #298, #319, #330, #354
DateTimePicker	#236	#247, #283, #285, #354
TabButtons	#220	#273, #354

Behaviour Changes

These changes affect the behavior of existing call sites without changing their prop types.

Change	Detail	Related PRs
DatePicker trigger	The children render prop is now wrapped in Popover.Trigger, so a custom trigger opens the popup on click without requiring onClick={togglePopover}. togglePopover remains available alongside the new openPicker, closePicker, onTriggerKeyDown, and disabled props.	#236, #283, #285
ListRow markup	Changes the row wrapper from <button className="[all:unset]"> to <div>, fixing invalid HTML and keyboard accessibility issues with nested controls.	#329
Spinner gradient ID	Uses useId instead of the hardcoded id="gradient" to prevent conflicts when multiple spinners are rendered. The stop color now uses currentColor, allowing the spinner color to inherit from className.	#281
MonthPicker year	Selecting a month now preserves the currently displayed year.	#351
Breadcrumbs renderPrefix / renderSuffix	These props are now correctly used instead of being shadowed by local definitions.	#351
Tooltip on touch	Tooltips now open on touch devices using pointerdown.	#346
Focus states	Replaces focus:ring-* and focus:outline-none with outline utilities across Button, Checkbox, Switch, Toast, Tabs, Dropdown, Sidebar, and inputs. Adds --focus-outline-* theme tokens and a global :focus-visible rule similar to Frappe UI.	#338

API Additions

Existing props are unchanged. New optional props only.

Component	Added	Related PRs
AutoComplete	children (element or trigger render-prop), open, onOpenChange, searchValue, onSearchChange, keepSelectedVisible, renderFooter, emptyMessage, className, labelClassName, triggerClassName, searchInputClassName, listClassName. options accepts null/undefined. onChange gains a second selectedOption argument.	#256, #259, #343
Badge	className	#351
Breadcrumbs	size, highlightLastItem, highlightAllItems, compactCrumbs, className, crumbClassName, separatorClassName. BreadcrumbItem gains id, interactive, and dropdown (a DropdownProps plus renderDropdown).	#317, #351
Checkbox	extraLabelClasses, extraWrapperClasses	#241, #354
Combobox	id, clearable, openOnFocus, searchValue, onSearchChange, loading, emptyMessage, inputClassName, popupClassName, tooltipOnTruncate. SimpleOption gains description.	#254, #307, #333, #355
DatePicker	disabled, sideOffset, footer. Children props gain disabled, openPicker, closePicker, onTriggerKeyDown.	#236, #283, #285, #332, #354
DateRangePicker	disabled, disallowAfter, sideOffset, footer	#236, #247, #283, #285, #298, #319, #330, #354
DateTimePicker	disabled	#236, #247, #283, #285, #354
Dialog	className, classNames (13 slots: backdrop, viewport, content, header, titleWrapper, title, iconWrapper, icon, closeButton, closeIcon, description, footer, actions)	#277
Divider	className	#351
Dropdown	side, dropdownClassName, groupClassName, itemClassName, selectedKey, selectedGroupKey, renderItems, renderMenuItem. DropdownOption gains key, DropdownGroupOption gains groupKey. ButtonProps now comes from the local Button, not Headless UI.	#317, #321
FormControl	children accepts AutoComplete's trigger render-prop	#220, #256, #354
FormLabel	children, className. label is now optional.	#334
ListView, ListHeader, ListHeaderItem, ListRow, ListRows	all forward arbitrary HTML attributes and merge className	#329, #354
MonthPicker	inputIcon	#351
MultiSelect	triggerLabel, triggerClassName, open, onOpenChange, searchValue, onSearchChange, positionerClassName, popupClassName	#258, #263, #275, #279, #343, #348
Select	className, placeholderClassName, matchTriggerWidth, suffix, option	#220, #278, #325, #328, #354
Sidebar	activeItemClassName, sectionDividers. Sections gain defaultOpen and an optional label. Items gain suffix and render.	#280, #286, #354
TabButtons	buttonClassName	#220, #273, #354
Textarea	className	#220, #354
TextEditor	extensionOptions (per-extension config for placeholder, taskList, taskItem, textAlign, highlight, table), mentions, mentionsItemRenderer. Forwards a TextEditorHandle ref exposing addListItem(id, text) and removeListItem(id).	#295, #323, #324
TextInput	readOnly, onKeyDown, inputClassName, and min/max/step gated by a discriminated union so they only type-check on number, range, date, month, week, time and datetime-local.	#283, #309
Tooltip	showWhen ("always" or "truncated"), truncationRef. Truncation is measured as scrollWidth > clientWidth.	#336, #346

Design Tokens

• Adds new surface tokens for green-4/5, amber-5, blue-4/5, and violet-5, and ink tokens for green-4, amber-4, cyan-3, and violet-3/4.
• Adds full violet and purple color scales.
• Adds --focus-outline-* variables and a global :focus-visible rule.
• Updates tailwindExtend.json with the new tokens for Tailwind v3 consumers.
• Adds 27 new icons: 16 in extras, 7 in line, and 4 in solid. extras also adds an index.ts exporting the five status icons.
• Moves Badge, Breadcrumbs, Select, Textarea, and TextInput class maps to co-located cva variant files.

Maintenance

• Upgrades Storybook from 9.x to 10.x and adds @storybook/addon-mcp.
• Expands interaction test coverage.
• Updates README documentation to require Node.js 24, matching .nvmrc, adds Base UI, and removes Radix UI since it is no longer a dependency.

Props

Mohammad Taqui Sayed ( @mohdsayed ), Aditya Dhade ( @b1ink0 ), Ayush Nirwal ( @ayushnirwal ), Praveen Kumar ( @PraveenKum11 ), Saransh Sinha ( @saranshsinhaa )

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.