# CHANGELOG

All notable changes to this project will be documented in this file.

> For v0.x changelog, see the [v0 branch](https://github.com/chakra-ui/zag/blob/v0/CHANGELOG.md)

## [1.42.0](./#1.42.0) - 2026-06-29

### Added

- **Number Input**: Add `largeStep` (defaults to `10 * step`, applied on `Shift`) and `smallStep` (defaults to
  `step / 10`, applied on `Alt`) props for configurable keyboard stepping. The defaults preserve the previous stepping
  magnitudes.

- **Slider**: Add `largeStep` prop (defaults to `10 * step`), applied on `Shift` or `PageUp`/`PageDown`. The default
  preserves the previous stepping magnitude.

### Fixed

- **Cascade Select**: Fix issue where pressing `Enter` on a highlighted leaf node did not select it in non-React
  frameworks.

- **Date Input**
  - Allow typing dates using the locale's native numerals (e.g. Arabic-Indic `٠-٩`, Devanagari `०-९`) in addition to
    ASCII digits. Latin-locale behavior is unchanged.
  - Fix timezone-naive values (`CalendarDate`/`CalendarDateTime`) being shifted by the viewer's local UTC offset when a
    custom `formatter` without an explicit `timeZone` is provided. The instant fed to the formatter is now built using
    the formatter's own resolved time zone, so a wall-clock value round-trips unshifted.

- **Date Picker**
  - Allow typing dates using the locale's native numerals (e.g. Arabic-Indic `٠-٩`, Devanagari `०-९`) in addition to
    ASCII digits.
  - Add date reordering on blur for range selection to match other selection paths.
  - Fix day view briefly flashing when closing the date picker from the month or year view.
  - Fix `visibleRangeText` returning a stale value when multiple date pickers with different `selectionMode` (or
    `timeZone`) share the same visible range. This previously surfaced as SSR hydration mismatches.

- **Menu**: Fix issue where the context menu briefly flashes at the top-left corner before positioning, and where a
  long-press (touch) context menu opens stuck at `(0,0)` without ever repositioning to the touch point.

- **Number Input**
  - Fix issue where calling `api.setValue` with a number throws when `formatOptions` is defined.
  - Fix `Cmd`/`Ctrl` + arrow keys producing values off the `step` grid (e.g. non-integer values when `step: 1`).

- **Slider**: Fix `Cmd`/`Ctrl` + arrow keys producing values off the `step` grid (e.g. non-integer values when
  `step: 1`).

- **Tags Input**: Fix native form submit so `FormData` reflects the current tags. The hidden input previously kept its
  initial value after tags were added, removed, or cleared.

- **Toast**: Fix toast height measurement including the `scale` transform in overlap mode, causing a height flicker when
  expanding the stack. Height is now measured from the untransformed element.

## [1.41.2](./#1.41.2) - 2026-06-05

### Fixed

- **Date Input**: Fix date segment placeholders for locales with explicit script subtags.

- **Drawer**
  - Fix controlled drawer flickering when swiped or backdrop-closed while the `open` setter is asynchronous (e.g.
    history API or a delayed state update).
  - Keep nested-drawer layout metrics in machine state so swipe and backdrop-close transitions stay visually stable.

- **Image Cropper**: Fix `getCroppedImage` and `getCropData` returning the wrong region when the image is displayed at a
  size different from its natural resolution (e.g. `width/height: 100%`).

- **Pin Input**: Fix issue where `data-filled` was incorrectly set on every input on first render.

- **Signature Pad**: Fix issue where the `dir` prop was accepted but never forwarded to the DOM.

## [1.41.1](./#1.41.1) - 2026-05-26

### Fixed

- **Dismissable**: Fix layer `pointer-events` being wiped by frameworks (Svelte, Vue) whose spread updates rewrite the
  entire `style` attribute.

- **Drawer**
  - Fix controlled drawers snapping back to open before the close animation when dismissed via swipe.
  - Fix indent and indent-background snapping back into place after the close animation instead of transitioning in
    sync.
  - Fix `--drawer-swipe-progress` jumping to `1` at the start of a dismiss swipe; it now goes smoothly from `0` (at
    rest) to `1` (fully dismissed).
  - Fix drawer freezing mid-drag on release when its content mounts lazily which left snap points unmeasured.

## [1.41.0](./#1.41.0) - 2026-05-22

### Added

- **Floating Components**: Add `data-side` to placement-aware parts based on the current placement.

  > Affected Components: Cascade Select, Color Picker, Combobox, Date Picker, Hover Card, Menu, Popover, Select,
  > Tooltip, Tour.

- **Date Input**
  - Add `hideTimeZone` prop. The `timeZoneName` segment now renders automatically when the value is a `ZonedDateTime`,
    and can be hidden via `hideTimeZone: true`.
  - Arrow navigation and auto-advance after typing now reach read-only focusable segments (e.g. `timeZoneName`). Typing
    the final editable segment (e.g. "P" on `dayPeriod`) advances focus to the trailing read-only segment instead of
    staying put.

- **Splitter**
  - Add CSS unit support for `defaultSize`, `minSize`, and `maxSize`. The splitter now accepts `px`, `em`, `rem`, `vh`,
    and `vw` in addition to percentages, and resolves them to percentages after hydration.

  ```tsx
  const service = useMachine(splitter.machine, {
    panels: [
      { id: "nav", minSize: "240px", maxSize: "480px" },
      { id: "main", minSize: 30 },
    ],
    defaultSize: ["240px", "60vw"],
  })
  ```

  - Add `resizeBehavior` per panel. Set to `"preserve-pixel-size"` to keep a panel's pixel size constant when the parent
    splitter group resizes. Leave at least one panel as `"preserve-relative-size"` (the default) so the layout can
    absorb the change.

  ```tsx
  panels: [
    { id: "nav", minSize: 20 },
    {
      id: "main",
      minSize: "240px",
      maxSize: "480px",
      resizeBehavior: "preserve-pixel-size",
    },
    { id: "aside", minSize: 20 },
  ]
  ```

  - Allow non-panel children inside the splitter root for fixed toolbars, rails, or status areas that should not be
    managed as panels. Use partial trigger ids (`"left:"`, `":right"`) to bind handles around the fixed element.

  ```tsx
  <div {...api.getRootProps()}>
    <div {...api.getPanelProps({ id: "left" })}>Left</div>
    <div {...api.getResizeTriggerProps({ id: "left:" })} />
    <div style={{ flex: "0 0 180px" }}>Fixed sized element</div>
    <div {...api.getResizeTriggerProps({ id: ":right" })} />
    <div {...api.getPanelProps({ id: "right" })}>Right</div>
  </div>
  ```

- **TOC**: Add `api.scrollTo(value, details?)` for programmatically scrolling to a heading. The optional
  `details.behavior` controls the scroll behavior; when omitted, the platform default applies.

  ```tsx
  api.scrollTo("installation", { behavior: "smooth" })
  ```

### Fixed

- **Accordion**: Remove redundant `aria-disabled` from accordion item triggers.

- **Color Picker**: Invoke `onValueChangeEnd` when the user picks a color with the EyeDropper API, consistent with
  ending a drag on the area or channel sliders.

- **Combobox**: Fix `Enter` no longer submits the form when an item is highlighted (regardless of `allowCustomValue`),
  or when the typed value will be rejected by `allowCustomValue: false`.

- **Date Input**
  - Fix min/max handling to preserve entered segments while editing. Values are now clamped segment-by-segment on blur,
    so `06/15/1999` with min `2000-01-01` becomes `06/15/2000` instead of snapping to `01/01/2000`.
  - Fix range mode keyboard navigation so `ArrowRight` moves from the last segment of the start date to the first
    segment of the end date.
  - Fix time-only formatters (no `year` segment) never firing `onValueChange` — `era` is now only required when `year`
    is present.
  - Fix `setSegmentValue` reading stale `displayValues`. `updateSegmentValue` returns the new `IncompleteDate` directly
    so the commit check uses the fresh value.
  - Fix `dayPeriod` (AM/PM) arrow up/down not updating the visible segment when `hourCycle` changes at runtime —
    `displayValues` now re-sync to the new hour cycle while preserving in-progress edits.
  - Fix typing "A" / "P" on the `dayPeriod` segment not updating the visible AM/PM. The typing path was writing `12` for
    PM while every other code path uses `1`, so the display silently stayed on AM.

- **Date Picker**
  - Fix `VALUE.CLEAR` not resetting `activeIndex` and `hoveredValue` in range mode when `getInputProps` inputs are not
    rendered.
  - Fix issue where the date input was not writable in locales whose date format separator contains more than one
    character (e.g. `cs-CZ`, `sk-SK`, `hu-HU`, `ko-KR` which use `". "`).
  - Fix issue in Firefox where native month/year `<select>` is not interactive when the picker is inside a modal dialog.
  - Fix range selection with `outsideDaySelectable`: hovering outside-month days no longer changes the visible month;
    hover preview for the end date still updates.

- **Dialog, Drawer, Hover Card, Menu, Popover, Tooltip**
  - Fix custom trigger elements (via `ids.trigger`) being ignored when shared across components (e.g. wrapping a
    `Popover.Trigger` in a `Tooltip` with the same id), causing broken positioning and a close-then-reopen cycle on
    trigger clicks.
  - Fix trigger element lookups in shadow root.

- **Dismissable**
  - Deduplicate `layerStack.add()` by DOM node so the same element is not registered twice (e.g. React Strict Mode).
    Fixes incorrect `data-has-nested`, `--layer-index`, and `--nested-layer-count` on a single open dialog.
  - Fix crash (`Cannot read properties of null (reading 'style')`) when a pointer-blocking dialog or popover closes
    during SPA route teardown.

- **Frameworks**: Fix dialog, drawer, and popover leaving `<body>` uninteractive (`data-scroll-lock`, `data-inert`,
  `overflow: hidden`, `pointer-events: none`) after closing under React 19 Strict Mode.

- **Number Input**: Fix inconsistent blur behavior when the input is cleared and `min` is greater than `0`.

- **Popper**
  - Fix `flip`, `shift`, and `hide` middleware ignoring a late-mounted `boundary`. The boundary is now re-resolved on
    every `computePosition` tick, so a function-form `boundary: () => element` picks up the element once it mounts.
  - Forward `boundary` into the `size` middleware so available width/height match `flip`/`shift`, with per-tick
    resolution for function boundaries.

- **Preact**: Avoid bundling `@zag-js/utils` and remove unused `proxy-compare`.

- **Remove Scroll**: Fix scroll lock leaking on `<body>` (`data-scroll-lock`, `overflow: hidden`) when nested dialogs or
  React Strict Mode trigger overlapping locks.

- **Splitter**
  - Fix clicking a `ResizeTrigger` not moving focus to it, which prevented arrow keys from resizing the splitter until
    it was tab-focused (notably on Safari).
  - Fix `data-focus` being applied on hover by only setting it when the trigger is actually focused.

- **Tabs**: Observe the tab list with `ResizeObserver` so the indicator rect updates when the list resizes without
  individual tab triggers changing size (e.g. responsive grid reflow).

### Changed

- **TOC**: Rename `getScrollEl` context prop to `scrollEl` for consistency with other machines (e.g. `initialFocusEl`,
  `finalFocusEl`).

## [1.40.0](./#1.40.0) - 2026-04-07

### Added

- **Popover**: Add `finalFocusEl` and `restoreFocus` props to control focus behavior when the popover closes.
  - `finalFocusEl`: specify an element to receive focus instead of the trigger
  - `restoreFocus`: set to `false` to prevent focus from returning to the trigger (default `true`)

  Both work in modal and non-modal modes.

### Fixed

- **Color Picker**: Fix color value to respect the specified `format` when setting values via props or `setValue`.
  Previously, the internal color object could retain a mismatched format (e.g., RGB when `format` is `hsla`), causing
  inconsistent `value` objects in `onValueChange` callbacks.

- **Date Input**: Defer min/max constraint until segment is fully typed or on blur to prevent resetting other segments
  mid-keystroke.

- **Date Picker**: Fix `isDateEqual` to consider time components of `CalendarDateTime` and `ZonedDateTime` values. This
  ensures `onValueChange` fires correctly when time segments change in the date input.

- **Navigation Menu**: Remove aggressive and redundant default `aria-label`.

- **Vanilla**: Do not use `{}` instead of `undefined` and `null` computed value (fixes `accept="[object Object]"` in
  File Upload with `accept: undefined`).

### Changed

- **Date Utils**: Remove unsupported `"month"` and `"year"` values from `DateGranularity` type.

## [1.39.1](./#1.39.1) - 2026-04-05

### Added

- **Floating Panel**: Add `initialFocusEl`, `finalFocusEl`, and `restoreFocus` props for focus management when the panel
  opens or closes.

### Fixed

- **Accordion**: Fix missing `data-focus` attribute on `getItemTriggerProps`. This makes the trigger consistent with
  other accordion parts (`getItemProps`, `getItemContentProps`, `getItemIndicatorProps`) which already expose
  `data-focus`.

- **Combobox**: Fix VoiceOver not announcing combobox options when navigating with arrow keys. Safari/VoiceOver ignores
  `aria-activedescendant` changes on combobox inputs, so we now use a live region to announce the highlighted item on
  Apple devices.

- **Menu**: Fix issue where quick diagonal pointer movement toward an open submenu could flash the highlight across
  sibling items you skim past. The active item now stays stable while you move fast toward the submenu.

- **Popper**: Fix incorrect positioning when the anchor or floating element changes while the popover is still open
  (e.g. switching between multiple triggers without closing first).

## [1.39.0](./#1.39.0) - 2026-04-02

### Added

- **Dialog, Drawer, Hover Card, Menu, Popover, Tooltip**

  Add support for multiple triggers. A single component instance can now be shared across multiple trigger elements.
  Each trigger is identified by a `value` passed to `getTriggerProps`:

  ```jsx
  const users = [{ id: 1, name: "Alice Johnson" }]

  const Demo = () => {
    const service = useMachine(dialog.machine, {
      id: useId(),
      onTriggerValueChange({ value }) {
        const user = users.find((u) => u.id === value) ?? null
        setActiveUser(user)
      },
    })

    const api = dialog.connect(service, normalizeProps)

    return (
      <>
        {users.map((user) => (
          <button {...api.getTriggerProps({ value: user.id })}>Edit {user.name}</button>
        ))}
      </>
    )
  }
  ```

  When the component is open and a different trigger is activated, it switches and repositions without closing.
  `aria-expanded` is scoped to the active trigger, and focus returns to the correct trigger on close.

- **Splitter**: Add multi-drag support for nested splitter layouts. When a horizontal and vertical splitter meet at the
  same point (e.g. a grid layout), users can drag the intersection to resize both directions at once.

  Create a shared registry and pass it to each splitter instance:

  ```ts
  // shared across all splitters on the page
  const registry = splitter.registry()

  // horizontal splitter
  const serviceH = useMachine(splitter.machine, { id: "h", registry })

  // vertical splitter (nested inside a panel of the horizontal one)
  const serviceV = useMachine(splitter.machine, { id: "v", orientation: "vertical", registry })
  ```

  The registry automatically detects when resize handles overlap, activates both splitters on drag, and switches the
  cursor to `move` at intersection points.

- **Tags Input**: Add `sanitizeValue` prop to normalize tag values before they are added. This runs on every new tag, so
  you can enforce consistent formatting in one place — strip whitespace, lowercase, remove special characters, etc.
  Defaults to `(v) => v.trim()`.

  ```ts
  const service = useMachine(tagsInput.machine, {
    // normalize emails to lowercase
    sanitizeValue: (v) => v.trim().toLowerCase(),
  })
  ```

- **Toast**: Add priority-based queue system. When the max number of visible toasts is reached, incoming toasts are
  queued and sorted by priority so the most important ones display first.

  Default priorities (1 = highest, 8 = lowest):

  | Type      | With action | Without action |
  | --------- | ----------- | -------------- |
  | `error`   | 1           | 2              |
  | `warning` | 3           | 6              |
  | `loading` | 4           | 5              |
  | `success` | 5           | 7              |
  | `info`    | 6           | 8              |

  Toasts with an action button are bumped higher because they require user interaction. You can override the automatic
  priority by passing a custom `priority` value:

  ```ts
  toaster.create({ type: "info", title: "Heads up", priority: 1 })
  ```

### Fixed

- **Date Input**: Fix crash in non-React frameworks (Vue, Solid, Svelte) where `event.nativeEvent.isComposing` is
  `undefined`. The composing check now uses a framework-agnostic utility that works across all adapters.

- **Splitter**: Fix `onResizeStart` and `onResizeEnd` callbacks to fire for programmatic resizes

- **Tags Input**: Set `enterKeyHint` to `"done"` on the input element so mobile virtual keyboards show a "Done" button
  that triggers tag addition

- **Tree View**: Add `data-checked` and `data-indeterminate` attributes to item and branch control elements for styling
  based on checked state

- **Vue**: Fix keyboard navigation for nested menus. ArrowRight now correctly opens submenus when using nested component
  patterns (e.g. Ark UI's `Menu.Root` inside `Menu.Root`)

## [1.38.2](./#1.38.2) - 2026-03-25

### Fixed

- **Dialog / Drawer**: Avoid setting inline `pointer-events` when modal, letting the dismissable layer manage it
  instead.

## [1.38.1](./#1.38.1) - 2026-03-25

### Fixed

- **File Upload**: Automatically reject duplicate files with `FILE_EXISTS` error. Previously, uploading the same file
  twice was silently accepted and deleting one duplicate removed all of them.

- **Toast**: Restore `role="region"` on the toast group element. The role was previously removed to reduce screen reader
  landmark noise, but this caused an axe `aria-prohibited-attr` violation since `aria-label` is not permitted on a `div`
  without a valid role.

- **Tour**
  - Fix step navigation events (`next`, `prev`, `setStep`) firing when the tour is inactive, bypassing the `start` flow
  - Fix popper styles not being cleaned up when transitioning from a tooltip step to a dialog/non-tooltip step

### Changed

- **Core**: Validate compound states at machine creation — throw if a state has child states but no `initial`, or if
  `initial` references a nonexistent child.

## [1.38.0](./#1.38.0) - 2026-03-24

### Added

- **Date Picker**
  - Add missing range data attributes (`data-range-start`, `data-range-end`, `data-in-hover-range`,
    `data-hover-range-start`, `data-hover-range-end`) to month and year cell triggers for range picker mode
  - `TableCellState` now includes `firstInRange`, `lastInRange`, `inHoveredRange`, `firstInHoveredRange`,
    `lastInHoveredRange`, and `outsideRange`
  - Range boundary dates now announce "Starting range from {date}" and "Range ending at {date}" for better screen reader
    context

- **Drawer**
  - Add `description` anatomy part with `aria-describedby` support on the content element
  - Add `SwipeArea` part for swipe-to-open gestures from screen edges

    ```tsx
    <div {...api.getSwipeAreaProps()} />
    ```

  - Add `getDescriptionProps()` and `getSwipeAreaProps()` to the connect API
  - Require intentional swipe movement before showing the drawer (no flash on pointer down)
  - Smooth settle animation from release point to fully open position
  - Add cross-axis scroll preservation to prevent drawer drag when scrolling horizontally
  - Add initial focus management for non-modal mode

- **Pin Input**
  - **No more holes**: Delete and Backspace now splice values left instead of leaving empty gaps. Deleting "2" from
    `[1, 2, 3]` yields `[1, 3, ""]` — not `[1, "", 3]`. Cut (`Ctrl+X`) behaves the same way.
  - **Smarter focus management**: Backspace always moves back, click and ArrowRight are clamped to the insertion point,
    same-key skip advances focus, and roving tabIndex treats the entire pin input as a single tab stop
  - **New keyboard shortcuts**: Home/End to jump to first slot or last filled slot, `enterKeyHint` shows "next" on
    intermediate slots and "done" on the last
  - Add `autoSubmit` prop to automatically submit the owning form when all inputs are filled
  - Add `sanitizeValue` prop to sanitize pasted values before validation (e.g. strip dashes from "1-2-3")

### Fixed

- **Date Picker**: Fix inverted year cell `selectable` state that caused years outside the visible decade or min/max
  range to appear selectable

- **Dialog**
  - Set `pointer-events: none` on positioner in non-modal mode so the page stays interactive
  - Add initial focus management for non-modal mode (mirrors popover behavior)
  - Fix `aria-modal` to reflect actual `modal` prop value instead of hardcoded `true`

- **Drawer**: Fix swipe-to-dismiss in controlled mode (`open: true` without `onOpenChange` now blocks dismiss)

- **Floating Panel**: Fix `closeOnEscape` not working when focus is on a child element (e.g., input) inside the panel

- **Focus Trap**: Fix focus trapping when the content has a single effective tab stop, such as a native radio group.
  Handle disconnected `initialFocus` nodes more safely.

- **Interact Outside**: Fix issue where nested popovers and select within popovers didn't toggle correctly in Safari due
  to `focusin` events racing with pointer interactions

- **Splitter**: Fix global cursor styles when splitter is used in a shadow root

### Changed

- **Date Picker**: `DayTableCellState.formattedDate` removed — use `valueText` instead (inherited from `TableCellState`)

- **Drawer**: Set `pointer-events: none` on positioner in non-modal mode so the page stays interactive

## [1.37.0](./#1.37.0) - 2026-03-16

### Added

- **Date Input**
  - Add paste support for ISO 8601 date strings
  - Add `api.focus()` method for programmatic focus
  - Add `createCalendar` prop for non-Gregorian calendar systems (e.g., Buddhist, Persian)
  - Add `isDateUnavailable` prop to mark specific dates as invalid

- **Table of Contents**: Initial release of table of contents machine that highlights active headings as you scroll

### Fixed

- **Dialog, Drawer**: Improve focus restoration by preferring the trigger element as a stable fallback return target
  after remount cycles

- **Floating Panel**: Fix `Escape` during drag or resize so floating panels restore their previous position or size
  correctly in non-React frameworks

- **Preact**: Fix Fast Refresh lifecycle edge cases where machine cleanup could hydrate from stale state and skip
  expected effect re-application

- **React**
  - Re-run entry actions after StrictMode remount
  - Fix Fast Refresh lifecycle edge cases where machine cleanup could hydrate from stale state and skip expected effect
    re-application

- **Radio Group**: Fix missing `aria-labelledby` on radio hidden input, ensuring `getByRole('radio', { name: '...' })`
  works in testing tools like Playwright

- **Toast**: Improve toast group accessibility by removing `role="region"` landmark to reduce screen reader noise and
  restructuring `aria-label` for more natural output (e.g., "Notifications, bottom (Alt+T)")

## [1.36.0](./#1.36.0) - 2026-03-11

### Added

- **Clipboard, Navigation Menu, Popover, Select, Timer, Toast, Tree View**: Add `translations` prop for localization of
  hardcoded accessibility labels

- **Listbox**
  - Add `keyboardPriority` to `getInputProps` to control whether input key handling prioritizes text editing or list
    navigation for `Home`/`End` and horizontal arrows in grid collections
  - Add `highlightFirst`, `highlightLast`, `highlightNext`, and `highlightPrevious` to the API for programmatic
    highlight navigation

- **Tags Input**: Add `allowDuplicates` prop to allow duplicate tags

  ```js
  useMachine(tagsInput.machine, {
    allowDuplicates: true,
  })
  ```

### Fixed

- **Carousel**
  - Fix controlled carousel inside dialog jumping or skipping pages
  - Fix carousel navigation inside CSS-transformed containers (e.g., dialogs with open/close animations)
  - Fix scroll position drifting when container layout shifts (e.g., scrollbar removal)

- **Color Picker**: Preserve vertical slider orientation on pointer updates

- **Date Input**: Improve focus management

- **Floating Panel**
  - Fix `open` taking precedence over `defaultOpen` during initialization
  - Fix `api.setPosition` and `api.setSize` to work independently of drag/resize state
  - Fix React `Maximum update depth exceeded` when content uses `ResizeObserver`
  - Fix maximize/minimize restore reverting to `(0, 0)` in controlled mode
  - Fix Escape during drag/resize to cancel and revert to original position/size

- **Menu**: Fix trigger to keep `aria-expanded="false"` when closed

- **Pin Input**: Fix crash when typing the same character in a completed pin input on frameworks that use native `input`
  event (Svelte, Vue, etc.)

- **Radio Group, Tabs**: Fix indicator only animating when value changes, not on initial render or resize

- **Vanilla**: Fix handling of controlled mode

## [1.35.3](./#1.35.3) - 2026-03-02

### Added

- **Date Input**: Initial release of date input machine

### Fixed

- **Carousel**
  - Fix issue where carousel inside a Portal (e.g., Dialog) computes incorrect page count due to incomplete DOM layout
    at mount time. The item-group container is now observed with a `ResizeObserver`, so snap points are recalculated
    when the container resizes
  - Keep page and indicators in sync after drag release and scroll settling
  - Handle rapid mixed interactions (drag, wheel, buttons, indicators) more consistently
  - Keep page state valid when `slidesPerPage`, `slidesPerMove`, direction, or orientation change
  - Make `slidesPerMove` (`auto`, `1`, `2`) progression more predictable

- **Combobox**: Improve controlled-mode synchronization and keep callback/item resolution behavior consistent across
  filtered collections

- **Listbox**: Improve controlled-mode synchronization and keep callback/item resolution behavior consistent across
  filtered collections

- **Select**: Improve controlled-mode synchronization and keep callback/item resolution behavior consistent across
  filtered collections

### Changed

- **I18n Utils**: `formatTime` now accepts `amLabel` and `pmLabel` as separate options instead of the previous
  `amPmLabels` object

## [1.35.2](./#1.35.2) - 2026-02-26

### Fixed

- Fix CJS build issues across all packages

## [1.35.1](./#1.35.1) - 2026-02-26

### Added

- **Core**: Add support for XState-style `#id` transition targets. `#...` targets now resolve by state node `id`, making
  cross-level transitions explicit.

### Fixed

- **Color Picker**: Fix a regression where clicking the color picker trigger while open did not close the popover

- **Docs**: Fix ESM JSON imports for Node loader compatibility. Add `with { type: "json" }` import attributes and set
  build target to `node20.10` so the ESM output works when loaded in `next.config.mjs`, velite, or other Node ESM
  contexts without `ERR_IMPORT_ATTRIBUTE_MISSING`

## [1.35.0](./#1.35.0) - 2026-02-26

### Added

- **Date Picker**
  - Add non-Gregorian calendar support via `createCalendar` prop
    - Support Persian, Buddhist, Islamic, Hebrew, and other calendar systems
    - Month names, year ranges, formatters, and navigation now respect the active calendar
  - Add `data-type` attribute to weekend table header and cell

### Fixed

- **Combobox**: Fix `onValueChange` returning empty `items` array when using controlled value

- **Popover**: Fix nested popover z-index layering by running `trackDismissableElement` before `trackPositioning`

- **Toast**: Fix types to ensure `parent`/`index` are exposed as props and `expand`/`collapse` are exposed on the store

- **Vanilla**: Fix `mergeProps` to ensure the `style` prop is always a string

## [1.34.0](./#1.34.0) - 2026-02-19

### Added

- **Cascade Select [New]**: Initial release of cascade select state machine

- **Date Picker**
  - Add `focus` option to `api.clearValue({ focus?: boolean })`
  - Add `api.setTime(time, index?)` for date-time picker support
  - Add `maxSelectedDates` prop to limit the number of selected dates in `multiple` selection mode
  - Add `api.isMaxSelected` to check if the maximum number of dates has been selected
  - Add `openOnClick` prop to open the calendar when clicking the input field (defaults to `false`)
  - Add `showWeekNumbers` support to display an ISO 8601 week number column in the day view

- **Date Utils**: Add `getWeekOfYear` utility for week number calculation

- **Drawer [New]**: Initial release of the drawer state machine. Replaces the previous `bottom-sheet` implementation and
  API naming

- **I18n Utils**: Add `formatTime` utility for locale-aware 12h/24h time formatting with optional seconds

- **Popover**: Add `sizeMiddleware` positioning option to optionally disable the size middleware for better scroll
  performance

- **Select**: Add `autoComplete` prop for browser autofill hints (e.g., `"address-level1"` for state fields)

### Fixed

- **Combobox**
  - Fix `aria-selected` being set on highlighted items instead of selected items, improving screen reader announcements
  - Fix `selectedItems` getting out of sync with `value` when controller ignores selection in controlled mode
  - Fix item disabled state not accounting for root-level `disabled` prop

- **Date Picker**
  - Fix `api.selectToday()` sending incorrect value format to state machine
  - Preserve time/timezone when selecting new dates (`CalendarDateTime` and `ZonedDateTime`)
  - Export `DateValue` type locally instead of re-exporting from `@internationalized/date` (v3.10.0+ compatibility)
  - Improve focus management in trigger-only mode: focus now correctly returns to the trigger element after selecting a
    date or clearing the value

- **Date Utils**: Fix `constrainValue` stripping time from `CalendarDateTime`/`ZonedDateTime` values

- **Dialog**: Fix issue where non-modal dialog closes on outside click even when `modal` is set to `false`

- **Listbox**: Fix DOM IDs

- **Number Input**: Fix issue where explicit `invalid` prop was ignored when value is out of range. The `invalid` prop
  now takes precedence over the internal `isOutOfRange` computation

- **Popover**: Improve performance by reducing style recalculations when scrolling with heavy content

- **Select**: Fix issue where autofill does not update value when the hidden select value changes

- **Svelte**: Fix `state_unsafe_mutation` warning that occurs due to state transition during component teardown

- **Toast**: Fix TypeScript compilation errors when building projects that use `@zag-js/toast`

## [1.33.1](./#1.33.1) - 2026-01-28

### Fixed

- **Date Picker**: Fix `visibleRangeText` to show correct format based on current view (year/month/day)

- **Dismissable**: Fix issue where closing a nested dialog/popover would incorrectly close its parent layers

- **File Upload**: Fix accessibility violations in file upload component
  - Remove invalid `aria-readonly` from dropzone (not valid for `role="button"`)
  - Add `aria-hidden` to hidden input to exclude from accessibility tree

- **Menu**: Fix glitchy submenu behavior when hovering between trigger items quickly

## [1.33.0](./#1.33.0) - 2026-01-24

### Added

- **Scroll Area**: Add overflow CSS variables to the viewport element for creating scroll fade effects:
  - `--scroll-area-overflow-x-start`: Distance from horizontal start edge in pixels
  - `--scroll-area-overflow-x-end`: Distance from horizontal end edge in pixels
  - `--scroll-area-overflow-y-start`: Distance from vertical start edge in pixels
  - `--scroll-area-overflow-y-end`: Distance from vertical end edge in pixels

- **Slider**: Add `thumbCollisionBehavior` prop to control how thumbs behave when they collide during pointer
  interactions:
  - `none` (default): Thumbs cannot move past each other; excess movement is ignored.
  - `push`: Thumbs push each other without restoring their previous positions when dragged back.
  - `swap`: Thumbs swap places when dragged past each other.

- **Steps**: Add validation and skippable step support:
  - `isStepValid(index)`: Block forward navigation when step is invalid (linear mode)
  - `isStepSkippable(index)`: Mark steps as optional, bypassing validation
  - `onStepInvalid({ step, action, targetStep })`: Callback when navigation is blocked
  - `api.isStepValid(index)` / `api.isStepSkippable(index)`: Check step state
  - `itemState.isValid()`: Lazy validation check per step

- **Tags Input**: Add `placeholder` prop that is applied to the input only when there are no tags

- **Tooltip**: Add `data-instant` attribute to tooltip content to indicate when animations should be instant (e.g., when
  switching between tooltips quickly)

### Fixed

- **Auto Resize**: Fix issue where change event is not emitted after clearing a controlled textarea programmatically

- **Collection, Tree View**: Fix initial focus issue when the first node or branch is disabled. Added `skip` option to
  `getFirstNode()` (matching `getLastNode()`) to respect collapsed branches. The initial focus now correctly targets the
  first visible non-disabled node.

- **Color Picker, Color Utils**: Fix color not updating in controlled mode when selecting black shades.
  - Fixed equality check to compare actual channel values instead of CSS string output
  - Auto-detect `defaultFormat` from initial color value instead of hardcoding `"rgba"`

- **Floating Panel**: Fix issue where double-clicking title bar while minimized would incorrectly maximize instead of
  restore

- **Image Cropper**
  - Fix issue where `reset()` destroys the cropper area
  - Fix issue where changing `aspectRatio` or `cropShape` props doesn't update the crop instantly
  - Add symmetric resize support when holding `Alt` key during pointer drag
  - Fix panning bounds in fixed crop mode at various zoom levels
  - Fix race condition where initial crop may not compute on page reload

- **Number Input**: Fix cursor positioning when clicking label or after scrubbing. The cursor now moves to the end of
  the input value instead of the start.

- **Pagination**: Fix issue where next trigger was not disabled when `count` is `0`

- **Slider**: Fix pointer movement when dragging slider thumb from its edge in `thumbAlignment="contain"` mode. The
  value calculation now correctly accounts for thumb inset, ensuring consistent behavior when clicking on the track to
  set a value or dragging the thumb from any position.

- **Switch**: Fix issue where `api.toggleChecked()` doesn't work as expected

- **Toast**: Fix issue where toasts created before the state machine connects are not shown

- **Tour**: Fix janky scroll behavior when navigating between tour steps. Changed `scrollIntoView` to use
  `block: "nearest"` instead of `block: "center"` so the page only scrolls when the target element is not already
  visible.

- **Vanilla**
  - Fix issue where vanilla machines do not have the option to change their props during runtime
  - Fix issue where some `aria-` attributes were toggled as boolean attributes and not as attributes with value strings

## [1.32.0](./#1.32.0) - 2026-01-02

### Added

- **Date Picker**: Add `onVisibleRangeChange` callback to notify when the visible date range changes. This callback
  fires when:
  - Clicking next/prev triggers
  - Selecting a month from the month dropdown
  - Selecting a year from the year dropdown
  - Focusing a date outside the current visible range
  - Any other action that changes the visible range

- **File Upload**
  - Add `readOnly` prop to prevent file modifications while keeping component visually active
  - Add `maxFilesReached` and `remainingFiles` to exposed API

- **Vanilla**: Initial release of the vanilla JavaScript adapter for Zag.js
  - `VanillaMachine` - Class-based wrapper for zag machines with start/stop lifecycle
  - `normalizeProps` - Converts React-style props to vanilla DOM attributes
  - `spreadProps` - Spreads props onto DOM elements with event listener management

  ```typescript
  import { VanillaMachine, normalizeProps, spreadProps } from "@zag-js/vanilla"
  import * as toggle from "@zag-js/toggle"

  const machine = new VanillaMachine(toggle.machine, { id: "toggle" })
  machine.start()

  const api = toggle.connect(machine.service, normalizeProps)
  spreadProps(buttonEl, api.buttonProps)

  machine.stop()
  ```

### Fixed

- **Carousel**: Fix issue where next/prev carousel buttons and indicators don't work when `dir="rtl"` is set

- **File Upload**
  - Fix issue where using `api.setClipboardFiles` doesn't run `transformFiles` and validation functions
  - Fix item element IDs to use `name-size` combination for uniqueness (prevents ID collisions with same-named files)

- **Focus Trap**: Fix focus trap crash when clicking labels in dialogs

- **Pin Input**: Fix issue in Vanilla.js where paste does not work due to `maxlength="1"` truncating clipboard data
  before the input event

- **Tour**: Fix issue where input elements inside the spotlight target were not interactive. The focus trap now includes
  both the tour content and the spotlight target as containers, allowing users to interact with elements inside the
  highlighted area

## [1.31.1](./#1.31.1) - 2025-12-10

### Fixed

- **Accordion, Menu**: Fix issue where querying elements by `aria-controls` attribute could fail when lazy mounting the
  content
- **Rating Group**: Fix issue where rating group becomes unfocusable via keyboard when value is 0

## [1.31.0](./#1.31.0) - 2025-12-05

### Added

- **Number Input**: Add `onValueCommit` callback that fires when the input loses focus or Enter is pressed

- **Pagination**
  - Add `getFirstTriggerProps()` and `getLastTriggerProps()` methods for navigating to first/last page
  - Add `boundaryCount` parameter for controlling boundary pages (start/end)
  - Implement balanced pagination algorithm for consistent UI elements
  - Maintain visual consistency with max 7 elements regardless of total pages

- **Tree View**: Added `scrollToIndexFn` prop to enable keyboard navigation in virtualized trees

### Fixed

- **Color Picker**
  - Add `role="dialog"` to color picker content when not inline to ensure proper `aria-controls` detection
  - Add `aria-haspopup="dialog"` to color picker trigger when not inline for better accessibility

- **Date Picker**: Fix issue where date picker input does not update format when locale changes

- **Listbox**
  - Fix issue in React where filtering items with an input would throw a
    `flushSync was called from inside a lifecycle method` warning
  - Fix issue where `data-highlighted` wasn't applied to the first item when using `autoHighlight` with input filtering

- **Number Input**
  - Fixed issue where input element doesn't sync when `formatOptions` changes dynamically
  - Ensure cursor position is preserved when `Enter` key is pressed and formatting is triggered
  - Fix cursor jumping to start when value is changed externally via props while user is typing

- **Pagination**: Fix ellipsis showing when only 1 page gap

- **Radio Group**
  - Fix issue where `radio-group` machine no longer shows the `indicator` prematurely
  - Improve accessibility of radio group by adding `invalid` and `required` props with corresponding `data-*` and
    `aria-*` attributes

- **Tabs**: Fix issue where `tabs` machine no longer shows the `indicator` prematurely

- **Tooltip**: Fix tooltip not showing when scrolling with pointer over trigger

- **Collapsible, Presence, Tour**: Fix machines setting reactive state in exit actions

### Changed

- **Tree View**: `getVisibleNodes()` now returns `{ node, indexPath }[]` instead of `node[]`. Returning the index path
  perhaps the most useful use of this function, hence the change.

  ```tsx
  // Before
  const nodes = api.getVisibleNodes()
  nodes.forEach((node) => console.log(node.id))

  // After
  const visibleNodes = api.getVisibleNodes()
  visibleNodes.forEach(({ node }) => console.log(node.id))
  ```

## [1.30.0](./#1.30.0) - 2025-11-26

### Added

- **Date Picker**
  - Add support for `required` and `invalid` props
  - Exposed `disabled` and `invalid` in the date picker API for better state access

- **Navigation Menu**
  - Add `getItemIndicatorProps` part for indicator styling
  - Add `closeOnClick` prop to `getLinkProps` to control whether the navigation menu closes when a link is clicked
    (defaults to `true`)

### Fixed

- **Floating Panel**
  - Fix issue where `dir` prop is ignored. The `dir` attribute is now properly delegated to all floating panel parts
  - Ensure double-click behavior doesn't trigger when `resizable={false}` is set
  - Double-click behavior now checks `event.defaultPrevented` to allow users to prevent the default behavior by calling
    `event.preventDefault()`

- **Navigation Menu**
  - Avoid focusing the trigger when hovering over it
  - Separate `ContentProps` from `LinkProps` for `getContentProps` - previously it incorrectly used `LinkProps`

- **Number Input**: Improve controlled usage by ensuring input element stays synced with controlled value

### Changed

- **Navigation Menu**: Removed `getIndicatorTrackProps` - use `getListProps` instead (list now includes
  `position: relative`)

  ```tsx
  // Before
  <div {...api.getIndicatorTrackProps()}>
    <div {...api.getListProps()}>
      {/* items */}
    </div>
  </div>

  // After
  <div {...api.getListProps()}> {/* now acts as indicator track */}
    {/* items */}
  </div>
  ```

## [1.29.1](./#1.29.1) - 2025-11-22

### Fixed

- **Floating Panel**
  - Fix issue where resize trigger with `n` axis was not explicitly set to `top: 0`
  - Fix issue where `draggable` and `resizable` options were not respected when set to `false`

- **Presence**: Fix regression where UNMOUNT transition might not be called consistently

## [1.29.0](./#1.29.0) - 2025-11-19

### Added

- **Carousel, Color Picker, Combobox, Date Picker, Select**: Add `value` to `OpenChangeDetails` for better context in
  change handlers

- **Splitter**: Add `getResizeTriggerIndicator` to render an indicator when resizing

- **Toast**: Expose viewport offset as CSS variables (`--viewport-offset-left`, `--viewport-offset-right`,
  `--viewport-offset-top`, `--viewport-offset-bottom`) on the toast group element

### Fixed

- **Carousel**: Fix dragging not working after scrolling with mouse wheel when `allowMouseDrag` is enabled

- **Combobox**: Fix `onHighlightChange` not being invoked when collection is filtered to empty results. The callback now
  correctly receives `{ highlightedValue: null, highlightedItem: null }` when the collection becomes empty

- **File Upload**: Fix issue where clicking on non-interactive children (icons, text) inside the dropzone doesn't open
  the file picker

- **Radio Group**: Fix inconsistent application of `data-focus-visible` and `data-focus` attributes

- **Splitter**: Fix disabled splitter showing resize cursor and allowing dragging

## [1.28.0](./#1.28.0) - 2025-11-12

### Added

- **Carousel**: Add support for `autoSize` prop to allow variable width/height slide items.

### Fixed

- **Carousel**: Fix dragging behavior that stops working after switching browser tabs or scrolling the page. The issue
  was caused by incorrectly checking `event.button` instead of `event.buttons` to detect interrupted drag operations.

- **Date Picker**: Fix issue where the range date picker crashes when typing the end date first and blurring the input
  field multiple times.

- **Image Cropper**
  - Fix issues with the controlled `zoom` prop not functioning as expected
  - Clamping offset for non-fixed crop area should be based on viewport rectangle

- **Presence**: Fix a bug where elements get stuck in unmountSuspended state during rapid hovering

- **Radio Group, Tabs**: Fix indicator prematurely showing when rect has not been resolved yet

- **Store**: Fix "Illegal invocation" errors by excluding native objects with special `this` bindings from being
  proxied.

- **Tabs**: Fix tabs indicator position not updating when inactive tabs change size.

- **Tags Input**: Fix issue where item delete trigger doesn't have `data-*` attached

## [1.27.1](./#1.27.1) - 2025-11-04

### Fixed

- **Combobox**
  - Fix focus stealing in controlled open mode
  - Remove problematic `aria-hidden` behavior to allow interaction with other page elements

- **All Components**: Export missing types across all machine packages

## [1.27.0](./#1.27.0) - 2025-11-01

### Added

- **Dialog, Popover**: Improve support for shadow DOM in interact outside and focus trap detection.

### Fixed

- **Marquee**: Fix Firefox flicker, use margin spacing, add GPU acceleration, and add `item` part.

- **Popover**: Improve support for shadow DOM in interact outside and focus trap detection.

- **Dialog**: Fix issue where setting `scrollbar-gutter: stable` in CSS caused an unwanted gap and layout shift when
  opening dialogs.

- **Slider**: Fix issue where programmatic value changes do not trigger the `onValueChangeEnd` callback. This affects
  the`setThumbValue`, `setValue`, `increment`, and `decrement` API methods.

## [1.26.5](./#1.26.5) - 2025-10-29

### Fixed

- **Date Picker**: Fix crash in range date picker when typing end date first by adding `null`/`undefined` checks when
  accessing date properties.

- **Image Cropper**
  - Fix not working resize API
  - Export missing types
  - Make the image cropper responsive

- **Radio Group**: Revert to using `offsetLeft`/`offsetTop` to fix indicator positioning in scrollable containers.

- **Tabs**: Revert to using `offsetLeft`/`offsetTop` to fix indicator positioning in scrollable containers.

- **Tour**
  - Fix issue where effects were not cleanup correct.
  - Fix issue where wait step doesn't work correctly.
  - Validate the configured steps on mount to ensure they are valid.

## [1.26.4](./#1.26.4) - 2025-10-23

### Added

- **Image Cropper [New]**: Initial release of image cropper state machine

- **Marquee [New]**: Initial release of marquee component for continuously scrolling content

### Fixed

- **Angle Slider**: Fix issue where clicking and dragging the angle-slider thumb from a non-center position causes
  unexpected value jumps. The thumb now maintains its relative position from the initial click point throughout the drag
  operation, providing more intuitive dragging behavior.

- **Slider**: Fix issue where slider thumb offset changes dynamically during drag, causing unexpected value jumps. The
  thumb now maintains a constant offset from the pointer throughout the drag operation, matching the initial grab
  position.

- **Svelte**: Refactor `mergeProps` to return the class values as an array, this delegates the resolution to Svelte's
  native class handling, which uses `clsx` internally. This ensures proper support for conditional classes, arrays, and
  objects.

- **Toast**: Fix issue in Solid.js where toasts collapse immediately when dismissing while hovering, by tracking pointer
  state and temporarily ignoring spurious mouse events during DOM mutations using requestAnimationFrame.

## [1.26.3](./#1.26.3) - 2025-10-18

### Fixed

- **Angle Slider**: Fix accessibility violation where the slider thumb element lacked an accessible name. The thumb now
  supports `aria-label` and `aria-labelledby` props, and automatically falls back to the label element's ID for proper
  ARIA labeling.

- **Select**: Fix accessibility violation where the required state was not set correctly to on the trigger.

- **Tags Input**: Fix issue where entering a custom tag with combobox integration required pressing `Enter` twice. The
  tags-input now correctly handles custom values when the combobox has no highlighted item (`aria-activedescendant` is
  empty), allowing the tag to be added on the first `Enter` press.

## [1.26.2](./#1.26.2) - 2025-10-14

### Fixed

- **Checkbox**
  - Fix issue where setting initial checked state to `indeterminate` doesn't work
  - Ensure `api.checkedState` returns the correct checked state (`boolean | "indeterminate"`)

- **Collapsible**: Fix issue where `dir` prop value was hardcoded to `ltr` instead of using the provided value

- **Combobox**: Fix issue where controlled single-select combobox does not propagate its initial value to `inputValue`

- **Listbox**: Fix issue where pressing Enter key when no highlighted item still calls `event.preventDefault()`

- **Radio Group**: Refactor to use `getBoundingClientRect()` for precise indicator positioning

- **Slider**
  - Fix issue where slider could stop abruptly when scrubbing thumb
  - Fix issue where range slider thumbs become stuck when dragged to the same position without `minStepsBetweenThumbs`

- **Tabs**: Refactor to use `getBoundingClientRect()` for precise indicator positioning

- **Tags Input**: Fix issue where `maxLength` doesn't apply to the edit input as well

## [1.26.1](./#1.26.1) - 2025-10-08

### Fixed

- **Tree View**
  - Fixed issue where pressing `F2` on any tree node would lock navigation and prevent selecting other nodes.
  - The rename feature now requires the `canRename` callback to be explicitly provided, making it opt-in rather than
    opt-out.

## [1.26.0](./#1.26.0) - 2025-10-06

### Added

- **Tree View**: [Experimental] Add support for renaming tree node labels with validation and control features.

  This feature enables users to edit tree node labels inline, unlocking use cases like file explorers, folder management
  systems, content hierarchies, and any tree-based interface where users need to rename items.

  **Key Features:**
  - Press `F2` on any node to enter rename mode
  - Input is automatically focused and synced with current label
  - Press `Enter` to submit or `Escape` to cancel
  - Blur event automatically submits changes
  - IME composition events are properly handled for international input

  **Validation & Control:**
  - `canRename` - Control which nodes are renameable based on node type or custom logic
  - `onRenameStart` - Called when rename mode starts (useful for analytics, showing hints)
  - `onBeforeRename` - Validate rename before accepting (e.g., prevent duplicates, empty names)
  - Empty name prevention - Automatically stays in rename mode if submitted name is empty/whitespace
  - Label trimming - Labels are automatically trimmed before being passed to callbacks
  - `onRenameComplete` - Handle the rename and update your collection

  **Styling & Visual State:**
  - `data-renaming` attribute - Added to both item and branch elements when in rename mode for easy styling
  - `nodeState.renaming` - Boolean property to check if a node is currently being renamed

### Fixed

- **Editable**: Fix issue where input value fails to revert after repeated full deletion

- **Focus Visible**: Fix `"Cannot assign to read only property 'focus'"` console error by gracefully handling
  environments where `HTMLElement.prototype.focus` is non-configurable.

- **Listbox**: Fix `splitProps` to avoid partial

- **Presence**: Fix race condition where dialog remains closed when `open` prop rapidly changes from `true` to `false`
  to `true`

- **Solid**: Fix issue where transition actions received stale event data

## [1.25.0](./#1.25.0) - 2025-09-28

### Added

- **Collapsible**: Add support for `collapsedHeight` and `collapsedWidth` props to control the dimensions of the
  collapsible content when in its collapsed state.

- **Focus Trap**: Allow elements referenced by `aria-controls` to be included in the trap scope. This makes it possible
  for menus, popovers, etc. to be portalled and work correctly.

- **Pagination**: Add `getPageUrl` prop for generating `href` attributes when using pagination as links.

```ts
const service = useMachine(pagination.machine, {
  type: "link",
  getPageUrl: ({ page, pageSize }) => `/products?page=${page}&size=${pageSize}`,
})
```

- **Slider**: Export `splitMarkerProps` helper.

### Fixed

- **Scroll Area**: Fix RTL horizontal scrollbar positioning on Safari

- **Slider**: Fix issue where slider continues dragging when disabled during drag operation.

- **Switch**: Fix issue where `data-active` is inconsistently applied when `disabled` state changes at runtime

## [1.24.2](./#1.24.2) - 2025-09-18

### Fixed

- **Date Picker**: Fix issue where year range picker doesn't show the hovered range

- **Date Utils**:
  - Fix issue where quarter presets returns incorrect date
  - Fix issue where year range picker doesn't show the hovered range

- **I18n Utils**:
  - **formatBytes**: Support `unitSystem` property to allow changing between decimal (1000 bytes) and binary (1024
    bytes) systems.

- **Number Input**: When `formatOptions` is used (like `style: "currency"`), the cursor would jump to the end of the
  input when typing in the middle. The cursor now maintains its relative position during formatting changes.

- **Pin Input**: Fix issue where using the keyboard shortcuts `Cmd+Backspace` and `Cmd+Delete` to delete text in pin
  inputs would insert "undefined" instead of clearing the field.

- **Scroll Area**: Fix issue where resize tracking was not observing the root element, which caused the scrollbar to not
  update when the root element's size changed.

## [1.24.1](./#1.24.1) - 2025-09-14

### Fixed

- **Core**: Fix issue where `mergeProps` throws when `props` is undefined or null

## [1.24.0](./#1.24.0) - 2025-09-13

### Added

- **Combobox**: Add `alwaysSubmitOnEnter` prop to allow bypassing the default two-step behavior (Enter to close
  combobox, then Enter to submit form) and instead submit the form immediately on Enter press. This is useful for
  single-field autocomplete forms where Enter should submit the form directly.

### Fixed

- **Editable**: Allow text selection in editable preview when `autoResize` is enabled

  Previously, when `autoResize` was set to `true`, the preview element had `userSelect: "none"` applied, preventing
  users from selecting text. This has been fixed by removing the `userSelect` style property.

- **File Upload**: Fix regression where clicking the trigger doesn't open the file picker when used within the dropzone

- **Hover Card**: Change default delay values for hover card to improve accessibility.
  - `openDelay`: from `700ms` to `600ms`

- **Menu**: Fix issue where keyboard activation of menu items with `target="_blank"` would open two tabs

- **Svelte**: Fix Svelte warning about state reference capturing initial value instead of current reactive state

- **Tooltip**: Change default delay values for tooltip to improve accessibility.
  [Learn more](https://www.nngroup.com/articles/timing-exposing-content)
  - `openDelay`: from `1000ms` to `400ms`
  - `closeDelay`: from `500ms` to `150ms`

## [1.23.0](./#1.23.0) - 2025-09-11

### Added

- **Dismissable**: Add support for layer types in dismissable layer stack. Layers can now be categorized as `dialog`,
  `popover`, `menu`, or `listbox`. This enables:
  - `data-nested` attribute on nested layers of the same type
  - `data-has-nested` attribute on parent layers with nested children of the same type
  - `--nested-layer-count` CSS variable indicating the number of nested layers of the same type

### Fixed

- **Core**: Fix issue where `mergeProps` strips symbols after merging

- **Dom Query**:
  - Fix issue where `isActiveElement` checks don't consider the Shadow DOM
  - Fix issue where `getActiveElement` returns `activeElement` rather than `null` for focusable web components with no
    focusable children

- **Menu**: Fix issue where hovering a partially visible item with pointer causes it to scroll into view

- **Tabs**: Fix issue where `ids` for `item` and `content` could not be customized

- **Toast**: Allow creating a toast store without any arguments

  ```tsx
  // before
  const store = toast.createStore({})

  // after
  const store = toast.createStore()
  ```

## [1.22.1](./#1.22.1) - 2025-08-27

### Fixed

- **Collection**: Fix issue where disabled items could be reached via typeahead

- **Date Picker**: Fix issue where datepicker doesn't revert to a valid value when the input value exceeds the min/max
  and blurred

- **Tags Input**: Fix issue where highlighted item doesn't clear when tabbing out of the input to an external button
  within the `control` part.

## [1.22.0](./#1.22.0) - 2025-08-26

### Added

- **Hover Card**: Add support for `disabled` prop

### Fixed

- **Color Picker**: Fix issue where color picker was not working correctly in RTL mode

- **Dismissable**: Expose `onRequestDismiss` custom event handler for event a parent layer requests the child layer to
  dismiss. If prevented via `event.preventDefault()`, the child layer will not dismiss when the parent layer is
  dismissed.

- **Number Input**
  - Omit the input `pattern` when `formatOptions` is provided. This prevents native pattern validation from conflicting
    with formatted values (e.g., currency or percent).
  - Handle empty values consistently across all format options.
  - Add `data-scrubbing` attribute to the number input parts.

- **Tooltip**
  - Set `closeOnPointerdown` to `false` when `closeOnClick` is set to `false`
  - Reduce bundle size by replacing `@zag-js/store` dependency with a lightweight store implementation.

## [1.21.9](./#1.21.9) - 2025-08-23

## Fixed

- **Async List**:
  - Fixed critical race conditions and dual operations in sort functionality that could cause stale data overwrites and
    unexpected behavior
  - Fixed event handling during async operations - users can now properly interrupt sorting with RELOAD, FILTER, or new
    SORT events
  - Enhanced `SortDetails` interface with `filterText` parameter for consistent filtering context across local and
    server-side operations

## [1.21.8](./#1.21.8) - 2025-08-22

### Fixed

- **Date Picker**:
  - Clear hovered range state after completing range selection instead of waiting for pointer to leave the calendar
    area.
  - Fix issue where month and year select labels don't update correctly when using `min`/`max` constraints.
  - Expose `disabled` on `api.getMonths()` and `api.getYears()` results to indicate options out of range for current
    constraints.

- **Listbox**:
  - Fix issue where first enabled item should be highlighted by default when listbox receives focus and no item is
    currently highlighted.
  - Add `getElement` to `scrollToIndexFn` details
  - Track collection changes and clear `highlightedValue` if the item is no longer in the collection.

- **Scroll Area**:
  - Avoid detecting hover state from portalled descendants.
  - Add `data-dragging` attribute to scroll area parts.

- **Select**: Add `getElement` to `scrollToIndexFn` details

- **Combobox**: Add `getElement` to `scrollToIndexFn` details

## [1.21.7](./#1.21.7) - 2025-08-19

### Added

- **Highlight Word**: Add `exactMatch` option that enables whole-word matching using regex word boundaries.

### Fixed

- **Menu**: Fix context menu repositioning logic

- **Scroll Area**: Add `data-hover` to scroll area

## [1.21.6](./#1.21.6) - 2025-08-17

### Fixed

- **Menu**: Fix context menu positioning bug where reopening at the same coordinates fails to reposition

- **Scroll Area**: Rename `data-hovering` to `data-hover` for consistency

## [1.21.5](./#1.21.5) - 2025-08-16

### Fixed

- **Scroll Area**:
  - Fix issue where scroll area thumb applies width/height incorrectly
  - Add `data-overflow-*` to content and corner
  - Add custom easing function support for smooth scrolling

## [1.21.4](./#1.21.4) - 2025-08-16

### Fixed

- **Scroll Area**: Ensure types are exported and fix incorrect `@zag-js/dom-query/src/query` import

- **ListCollection**
  - Avoid recomputing groups on every call to `at()` and `indexOf()`
  - Fixed bug in `find()` method (was checking `!= null` instead of `!== -1`)

- **GridCollection**: Avoid recomputing rows on every call to `getRows()`

- **Menu**: Add `data-state` attribute for context menu trigger

## [1.21.3](./#1.21.3) - 2025-08-14

### Fixed

- **Listbox**: Add support for navigating grid collections

### Changed

- **Async List**: Improve type inference for descriptors

- **Framework Components**: Improve runtime performance of components by removing refs/events from stateful to
  non-stateful objects (affects Svelte, Solid, and Vue components)

## [1.21.2](./#1.21.2) - 2025-08-13

### Added

- **Scroll Area**: Initial release of scroll area state machine

### Fixed

- **Carousel**:
  - Fix an issue where the carousel would not update when `slideCount` or `autoplay` props change.
  - Fix an issue where `loop: false` was ignored when using autoplay. Now, the carousel will stop when it gets to the
    last slide.

- **Date Picker**: Expose `data-inline` attribute on Content part to enable distinct styling for inline date pickers
  versus popover date pickers.

- **Menu**: Fix issue where `onCheckedChange` could be called twice on checkbox or radio item

- **Radio Group**: Fixed issue where arrow key navigation doesn't apply `data-focus-visible` on the newly focused item.

## [1.21.1](./#1.21.1) - 2025-07-31

### Fixed

- **Carousel**: Fix issue where controlled carousel ignores last slide

- **Tour**: Re-expose `WaitOptions`

- **Floating Panel**: Add data attributes for floating panel stage status

## [1.21.0](./#1.21.0) - 2025-07-26

### Added

- **File Upload**: Add `api.transforming` to track file transformation state when using `transformFiles`. This enables
  developers to show loading states during file processing.

### Fixed

- **Dialog**
  - Sync content `--layer-index` with positioner and backdrop
  - Decouple `trapFocus` from `modal` so it's possible to set `modal=false` and `trapFocus=true`

## [1.20.1](./#1.20.1) - 2025-07-23

### Fixed

- **Date Picker**: Fixed issue where hovered range was connect to selected values, when it shouldn't

- **Tree View**: Fixed issue where tree view doesn't scroll into view when content overflows.

## [1.20.0](./#1.20.0) - 2025-07-22

### Fixed

- **Date Picker**: Fix date comparison issues when time components are involved. This resolves critical issues with date
  comparison operations when different date types (`CalendarDate`, `CalendarDateTime`, `ZonedDateTime`) are mixed,
  particularly in scenarios involving time components.

### Added

- **Date Picker**: Added hover range preview support for date picker range selection. Added `inHoveredRange`,
  `firstInHoveredRange`, and `lastInHoveredRange` properties to `DayTableCellState` with corresponding data attributes
  `data-in-hover-range`, `data-hover-range-start`, and `data-hover-range-end`.

  Hover range states are only active when not overlapping with actual selected range, enabling distinct styling for
  hover preview vs actual selection in range mode.

## [1.19.0](./#1.19.0) - 2025-07-20

### Added

- **File Upload**: Add support for programmatically controlling the accepted files via `acceptedFiles` and
  `defaultAcceptedFiles`

- **Signature Pad**: Add support for programmatically controlling the paths via `paths` and `defaultPaths` props.

## [1.18.5](./#1.18.5) - 2025-07-19

### Added

- **JSON Tree Utils**: Add support for `groupArraysAfterLength` to truncate large arrays into chunks (reducing the
  number of DOM nodes rendered).

### Fixed

- **General**: Fix issue destructuring returned api could throw an ESLint `unbound-method` warning

- **Tree View**: Fix issue where `onExpandedChange`, `onSelectionChange` and `onFocusChange` doesn't infer the tree node
  types

- **Popper**: Expose floatingElement to the `updatePosition` function

## [1.18.4](./#1.18.4) - 2025-07-18

### Fixed

- **Collection**: Fix issue where the `filter` method completely deletes the children key from the node when there are
  no matching children

- **Number Input**: Fix issue where default pattern does not allow negative numbers with decimal point

## [1.18.3](./#1.18.3) - 2025-07-05

### Fixed

- **Carousel**: Fix issue where full page carousel could trap scrolling

- **File Upload**:
  - Fix issue where calling `api.setFiles` invokes validation with incorrect `acceptedFiles`
  - Fix issue where the browser might not be able to infer the mime type of a file due to limitations, drag source or
    security restrictions. As a fallback in the file validation logic, we now infer the mime type from the file
    extension.

## [1.18.2](./#1.18.2) - 2025-07-04

### Added

- **Collection**: Add `upsert` to list collection. Useful for making creatable items in select or combobox

### Fixed

- **Date Picker**: Fix issue where `focusedValue` could not be fully controlled
- **Toast**: Fix issue where toast `title` or `description` could not accept React or Vue elements

## [1.18.1](./#1.18.1) - 2025-07-02

### Fixed

- **Combobox**:
  - Expose `reason` to `onOpenChange` and `onInputValueChange` callbacks
  - Select highlighted item only if it exists in the collection
  - Expose `api.clearHighlightedValue` function to clear highlighted value

- **Date Picker**: Fix issue where datepicker errors when setting `selectionMode=range` and `minView=year`

- **Listbox**: Select highlighted item only if it exists in the collection

- **Progress**: Improve `valueAsString` formatting

- **Select**:
  - Select highlighted item only if it exists in the collection
  - Expose `api.clearHighlightedValue` function to clear highlighted value

- **Tour**: Fix an issue where the `goto` function in `StepActionMap` doesn't work when passing step IDs (string)

- **Tree View**: Expose `id` in the tree node state

## [1.18.0](./#1.18.0) - 2025-06-30

### Added

- **Color Picker**: Add support for `inline` prop to render color picker inline
- **Date Picker**: Add support for `inline` prop to render the date calendar inline

### Fixed

- **Aria Hidden**: Exclude elements with `role="status"` and `output` elements when applying aria-hidden
- **Color Picker**: Auto-prefix Hex values with `#` if missing when using the `hex` channel input
- **Menu**: Fix interaction outside detection for focusable context trigger
- **Tree View**: Improve support for rendering tree items as links

## [1.17.4](./#1.17.4) - 2025-06-27

### Fixed

- **Combobox, Select, Listbox**: Fix issue where rehydrating `defaultValue` or `value` after fetching items doesn't
  update the `valueAsString`

## [1.17.3](./#1.17.3) - 2025-06-27

### Fixed

- **Tree View**: Fix tree traversal for querying last node

## [1.17.2](./#1.17.2) - 2025-06-26

### Fixed

- **Angle Slider**: Fix issue where scrubbing doesn't feel smooth on touch devices

- **Timer**:
  - Fix issue where timer could continue beyond `targetMs` when window is not visible
  - Add validation to ensure `startMs` and `targetMs` are configured correctly
  - Fix `progressPercent` calculation for countdown timers

- **Tree View**: Expose node details in `onExpandChange`, `onSelectionChange` and `onFocusChange`

### Changed

- **Collection**:
  - Add support for `findNodes` to find multiple nodes by value in a single pass
  - Fix issue with `getLastNode` not returning the last node in the tree with only one branch

- **I18n Utils**: Add new `createCollator` function for locale sensitive string comparison

## [1.17.1](./#1.17.1) - 2025-06-24

### Fixed

- **Date Picker**: Fix issue with keyboard selection where setting unavailable date causes month view to behave
  differently from clicking with mouse

- **Toast**: Fix issue where app crashes when `toaster.promise` is called without loading option. The `loading` option
  is now required. A warning will be logged if it is not provided

- **Tree View**:
  - Fix issue where clicking a branch with indeterminate state doesn't check its child nodes
  - Remove `aria-busy` attribute from branch trigger when not loading children

## [1.17.0](./#1.17.0) - 2025-06-23

### Fixed

- **Progress**: Fix issue where setting orientation to `vertical` don't work
- **Progress**: Fix issue where setting `defaultValue` to `null` doesn't show indeterminate state

### Changed

- **Tree View**: Rename `getItemCheckboxProps` to `getNodeCheckboxProps` since it can be used in both items and branches

## [1.16.0](./#1.16.0) - 2025-06-21

### Added

- **Tree View**
  - Add support for checkbox state for checkbox trees via `defaultCheckedValue`, `checkedValue`, `onCheckedChange` props
  - Add callback for when `loadChildren` fails via `onLoadChildrenError` prop
  - Add `api.getCheckedMap` method to get the checked state of all nodes

- **Tree Collection**: Add support for `getDescendantNodes` and `getDescendantValues`

### Fixed

- **Tree View**: Fix issue where `api.collapse` and `api.deselect` throws error when called without arguments
- **General**: Add better support for TypeScript's `exactOptionalPropertyTypes` compiler option

## [1.15.7](./#1.15.7) - 2025-06-19

### Fixed

- **Collection**: Fix issue where tree collection filter method returns empty children for leaf item.

## [1.15.6](./#1.15.6) - 2025-06-18

### Fixed

- **General**: Ensure pointerdown or click event handlers only execute when the main button is clicked

### Changed

- **Collection**: Improve the APIs around `tree.flatten(...)` and `flattenedToTree` to ensure the original node
  properties are preserved.

  > Previously, `tree.flatten()` would return an array of objects with `value` and `label` stripping out the original
  > node properties.

  ```ts
  const tree = new TreeCollection({
    rootNode: {
      value: "ROOT",
      children: [{ value: "child1" }, { value: "child2" }],
    },
  })

  const flattened = tree.flatten()
  const reconstructed = flattenedToTree(flattened)

  console.log(reconstructed.rootNode)

  // {
  //   value: "ROOT",
  //   children: [{ value: "child1" }, { value: "child2" }],
  // }
  ```

## [1.15.5](./#1.15.5) - 2025-06-17

### Fixed

- **Combobox**: Fix issue where combobox with `allowCustomValue: true` used within in a form requires two enter keypress
  to submit

## [1.15.4](./#1.15.4) - 2025-06-16

### Fixed

- **Menu, Combobox**: Fix issue in Svelte where menu and combobox items rendered as links don't work
- **Toggle Group**: Fix issue in Svelte where toggle group doesn't work due to blur timing

## [1.15.3](./#1.15.3) - 2025-06-13

### Fixed

- **Popover**: Fix issue where `onOpenChange` could be called twice when controlled
- **File Utils**: Improve `downloadFile` function to handle webview scenarios
- **Combobox**: Fix issue where `onInputValueChange` could be called twice when selecting an item

## [1.15.2](./#1.15.2) - 2025-06-10

### Fixed

- **Menu**: Refactor `getItemTextProps` and `getItemIndicatorProps` to accept a partial interface of option item.

## [1.15.1](./#1.15.1) - 2025-06-10

### Added

- **[NEW]Async List**: Initial release of async list controller
- **Editable**: Add support for `activationMode=none`
- **Collection**:
  - Expose `copy` method
  - Allow `getParentNodes` to accept a value or index path

### Fixed

- **Carousel**: Fix issue where carousel crashes when `slidesPerPage` is 0
- **File Upload**: Prevent `undefined` in `acceptedFiles` when no files accepted
- **Select**: Fix issue where highlighted item could be cleared when navigating up/down the list with keyboard
- **Tabs**: Fix issue where tabs with links should not trigger tab change upon cmd/middle click

## [1.15.0](./#1.15.0) - 2025-06-05

### Added

- **Tree View**: Add support for lazy loading node children. To use this, you need to provide:
  - `loadChildren` is a function that is used to load the children of a node.
  - `onLoadChildrenComplete` is a callback that is called when the children of a node are loaded. Used to update the
    tree collection.
  - Add `childrenCount` to the node object to indicate the number of children.

```tsx
function TreeAsync() {
  const [collection, setCollection] = useState(initCollection)

  const service = useMachine(tree.machine, {
    id: useId(),
    collection,
    async loadChildren({ valuePath, signal }) {
      const url = `/api/file-system/${valuePath.join("/")}`
      const response = await fetch(url, { signal })
      const data = await response.json()
      return data.children
    },
    onLoadChildrenComplete({ collection }) {
      setCollection(collection)
    },
  })

  // ...
}
```

### Fixed

- **Collapsible**: Fix rect measurement timing issue in Svelte
- **Remove Scroll**: Fix scrollbar width calculation before DOM change for scroll-lock workaround compatibility
- **Slider**:
  - Fix issue where `Shift` + `ArrowRight` set value to `0` instead of `max` when step is too large (e.g. `20`)
  - Fix issue where `onValueChangeEnd` doesn't return the latest value when dragging very fast

## [1.14.0](./#1.14.0) - 2025-05-29

### Added

- **File Upload**: Add support for transforming uploaded files via `transformFiles` context property.

```tsx
const service = useMachine(fileUpload.machine, {
  id: useId(),
  accept: ["image/jpeg", "image/png"],
  transformFiles: async (files) => {
    return Promise.all(files.map((file) => compress(file, { size: 200 })))
  },
})
```

### Fixed

- **Slider**: Fix issue where `minStepsBetweenThumbs` isn't computed correctly when interacting with pointer or
  keyboard.

## [1.13.1](./#1.13.1) - 2025-05-27

### Fixed

- **Password Input**
  - Export missing types for `Api` and `Service`
  - Add `api.toggleVisible` function to toggle the visibility of the password input
  - Implement `translations` prop to customize the visibility trigger accessibility label

## [1.13.0](./#1.13.0) - 2025-05-26

### Added

- **[New] Password Input**: Add password input machine for displaying a password input field.
- **Select**: Add `onSelect` callback that gets fired when an item is selected via keyboard/mouse.

### Fixed

- **Color Picker**: Fix issue where value change end event is invoked when committing via an input.

- **Svelte**: Fix issue with microtask timing in svelte `5.28.3+`.

- **Toast**: Fix issue where calling `toast.remove()` without an id shows a TypeScript error.

## [1.12.4](./#1.12.4) - 2025-05-20

### Fixed

- **Svelte**: Improve reactivity of synchronous state updates.

## [1.12.3](./#1.12.3) - 2025-05-16

### Fixed

- **Carousel**:
  - Fix issue where focusing on carousel region and navigating with keyboard doesn't work as expected
  - Fix issue when `allowMouseDrag` is set where carousel no longer snaps after mouse interaction

- **Combobox**: Fix issue where `onInputValueChange` doesn't get called when `autoFocus` is set to `true`

- **Focus Visible**: Fix an issue where an assignment to the browser's `HTMLElement` prototype is not supported (e.g.
  happy-dom)

- **Preact**: Remove `react` and `react-dom` from peerDependencies

- **Slider**: Fix issue where slider could throw a error when rendered in an popover or dialog

- **Svelte**: Improve reactivity when events don't trigger a state transition

- **Tour**: Fix issue where calling `api.start(<id>)` with a step id doesn't work as expected

## [1.12.2](./#1.12.2) - 2025-05-12

### Fixed

- **Select, Menu, Tabs**: Fix type issue with the `navigate` prop

## [1.12.1](./#1.12.1) - 2025-05-12

### Fixed

- **Collection**: Fix issue where `getNextValue` and `getPreviousValue` doesn't work as expected when `groupBy` is used.

- **Combobox**:
  - Fix issue in Vue.js where combobox doesn't work for items rendered as link
  - Add `href` to params in `navigate` context property

- **Menu, Tabs**: Add `href` to params in `navigate` context property

## [1.12.0](./#1.12.0) - 2025-05-01

### Added

- **Date Picker**: Add support for `outsideDaySelectable` prop to allow selecting days outside the current month (on the
  same visible date range)

### Fixed

- **Collapsible**: Fix issue in React.js <= v18.x where collapse animation might not work as expected

## [1.11.0](./#1.11.0) - 2025-04-20

### Added

- **ListCollection**: Add support for grouping collection items

### Fixed

- **Listbox**: Export missing `SelectionMode` interface

## [1.10.0](./#1.10.0) - 2025-04-15

### Added

- **Toggle Group**: Add support for `deselectable` prop to ensure one or more toggle is selected at any time.

- **Splitter**:
  - Expose `api.resetSizes()` to reset the size to the initial specified size
  - Fix issue in vertical orientation where arrow up doesn't work as expected.

### Fixed

- **Select**: Fix issue where machine doesn't leave focus state when interacting outside with another editable element.
  This leads to the `data-focus` attribute not being removed from the trigger element.

- **Floating Panel**: Fix issue where clicking the trigger when panel is open, doesn't close the panel

## [1.9.3](./#1.9.3) - 2025-04-10

### Fixed

- **Floating Panel**
  - Change default strategy from `absolute` to `fixed` to improve positioning consistency
  - Implement controlled open/close state
  - Constraint the mouse movement to the boundary rect to prevent content from being moved outside completely

## [1.9.2](./#1.9.2) - 2025-04-10

### Fixed

- **Floating Panel**: Fix issue where `StageTriggerProps` and `AnchorPositionDetails` was not exported

## [1.9.1](./#1.9.1) - 2025-04-10

### Changed

- **Floating Panel**
  - Update props and APIs to be consistent with other components
  - Fix issue where position and size were not synchronized correctly

## [1.9.0](./#1.9.0) - 2025-04-09

### Added

- **Toast**: Add support for queuing toasts that exceed the maximum limit. When the maximum number of toasts is reached:
  - New toasts are added to a queue instead of being dropped
  - Queued toasts are automatically displayed when space becomes available
  - Queue is cleared when all toasts are removed

- **Listbox**
  - Add support for clearing selection on Escape press
  - Add `api.clearHighlightedValue` function to clear the highlighted value
  - Add `data-empty` attribute to indicate when the listbox is empty

- **Collection**: Add `filter` function to collection methods

### Fixed

- **Listbox**: Fix keyboard navigation when no item is highlighted
- **Combobox**: Fallback to trigger element as the positioning anchor

### Changed

- **Combobox**: Add `data-empty` attribute to the listbox and content to indicate when the listbox is empty

## [1.8.2](./#1.8.2) - 2025-04-04

### Fixed

- **Tabs, Radio Group**: Fix Next.js issue where indicator size might not be mentioned when conditionally rendering the
  component and `defaultValue` is set.

## [1.8.1](./#1.8.1) - 2025-04-04

### Fixed

- **Listbox**
  - Fix issue where keyboard focus loops when `loopFocus` was not set.
  - Fix issue where `extended` selection mode was not working as expected.

- **Dom Query**: Improve platform detection logic to detect `macOS` and `iOS` correctly.

## [1.8.0](./#1.8.0) - 2025-04-04

### Added

- **[New] Listbox**: Add listbox machine for displaying a list of selectable options, supporting both single and
  multiple selection modes.

### Changed

- **ListCollection**: Fix staleness issues in mutation methods by returning a new `ListCollection` instead of mutating
  the internal `items`

### Fixed

- **Tabs**: Fix issue where tabs indicator animation behaves inconsistently.

- **Date Picker**
  - Fix issue where datepicker throws error when navigating month view.
  - Fix issue where range selection doesn't reset correctly when clicking the same start date.

- **Interact Outside**
  - Fix issue where pointerdown outside doesn't work consistently on mobile devices.
  - Improve pointerdown outside click detection in shadow DOM environments.

## [1.7.0](./#1.7.0) - 2025-03-28

### Added

- **Slider**
  - Add support for `origin: end` to align the thumb to the end of the track.
  - Expose `thumbSize` as CSS variables in the root element. Can be useful for styling the slider.

- **Menu**: Fix issue where `addItemListener` doesn't work as expected.

### Fixed

- **Slider**: Fix issue where `thumbSize` CSS variable is not applied.

## [1.6.2](./#1.6.2) - 2025-03-27

### Fixed

- **Frameworks**: Ensure machine has started before processing events.
- **Menu**: Add `addItemListener` function to allow listening for dispatched custom event on menu item.

## [1.6.1](./#1.6.1) - 2025-03-26

### Fixed

- **HoverCard, ColorPicker**: Add missing `tabIndex` to improve usage within dialogs
- **Menu**
  - Fix issue where menu items don't have a unique id leading to accessibility and HTML validation issues
  - Dispatch `menu:select` event on the menu item when it is selected

## [1.6.0](./#1.6.0) - 2025-03-24

### Added

- **Collapsible**: Add collapsible indicator part

### Fixed

- **Splitter**: Fix issue where `onResizeStart` and `onResizeEnd` callbacks are not called when using keyboard

- **Combobox**: Fix issue where `onOpenChange` with the same `open` value

### Changed

- **Color Utils**: Export `ColorStringFormat` type

## [1.5.0](./#1.5.0) - 2025-03-20

### Fixed

- **File Utils**: Fix issue in `downloadFile` where `name` is not considered in some cases

### Changed

- **Number Input**: Set the default step to `0.01` when `formatOptions.style` is set to `percent`

- **[Breaking] Splitter**: Redesign splitter machine to support more use cases and improve DX.

  Before:

  ```ts
  const service = useMachine(splitter.machine, {
    id: useId(),
    defaultSize: [
      { id: "a", size: 50 },
      { id: "b", size: 50 },
    ],
  })
  ```

  After:

  ```ts
  const service = useMachine(splitter.machine, {
    id: useId(),
    panels: [{ id: "a" }, { id: "b" }],
    defaultSize: [50, 50],
  })
  ```

  The also comes with new features such as:
  - Support for collapsible panels
  - Support for collapse and expand events
  - Methods for resizing the panels programmatically

## [1.4.2](./#1.4.2) - 2025-03-18

### Fixed

- **Toast**: Fix issue where setting `offsets` to `undefined` causes machine to throw

- **Select**: Fix issue where select `valueAsString` loses reactivity

## [1.4.1](./#1.4.1) - 2025-03-17

### Fixed

- **Slider**: Fix issue where value normalization doesn't work as expected

## [1.4.0](./#1.4.0) - 2025-03-14

### Added

- **Splitter**
  - Add `api.setSizes` to set the size of multiple panels
  - Add `api.getSize` to get the size of a panel

### Fixed

- **Number Input**: Fix issue where number input `onValueChange` is called with incorrect `valueAsNumber`

- **Slider**: Fix issue where setting `min` to value other than `0` causes incorrect initial placement of thumbs

## [1.3.3](./#1.3.3) - 2025-03-10

### Fixed

- **Combobox**: Fix issue where cursor moves unexpected when editing input value

- **Tags Input**: Improve caret detection logic to prevent unwanted tag removal

- **Timer**
  - Fix issue where timer slows down when switching tabs/windows
  - Change default `interval` value from `250` to `1000`

## [1.3.2](./#1.3.2) - 2025-03-08

### Fixed

- **Pin Input**: Fix issue where OTP SMS autofill doesn't work as expected.

- **Date Picker**: Fix issue where Svelte throws a `state_unsafe_mutation` error when controlling the datepicker range
  mode.

- **Rating Group**: Fix issue where rating group label places focus incorrectly.

- **React**: Flush effects synchronously rather than within a microtask.

- **Checkbox**: Fix issue where checkbox incorrectly sets `data-invalid` when `invalid` is `false`.

## [1.3.1](./#1.3.1) - 2025-03-05

### Fixed

- **Radio Group, Switch**: Improve focus behavior in Safari browser.

- **Accordion**: Fix issue in Safari where clicking triggers doesn't show the content as expected.

- **Auto Resize**:
  - Fix issue where height calculations could be incorrect in high DPI scenarios.
  - Account for `maxHeight`, `overflowY`, and `boxSizing` CSS properties.
  - Calculate height when its form owner resets.

## [1.3.0](./#1.3.0) - 2025-03-03

### Fixed

- **General**: Fix issue where machines that hold complex objects could cause issues.

### Added

- **Date Picker**:
  - Add support for `api.getViewProps`.
  - Add `visibleRangeText` property to `api.offset()` return value.

- **Progress**: Add support for `locale` and `formatOptions` to properly format the `api.percentAsString` result.

- **Framework Adapters (React, Svelte, Solid, Vue)**: Support `reenter:true` in machine transitions.

## [1.2.1](./#1.2.1) - 2025-02-27

### Fixed

- **Progress**: Allow for more precise (decimal) values.

- **Scroll Snap**: Fix issue where `getScrollPadding` could return `NaN` in test environments.

- **Date Picker**: Fix issue where `onValueChange` doesn't get called when value is cleared.

- **Number Input**: Fix issue where `allowOverflow` was not implemented.

## [1.2.0](./#1.2.0) - 2025-02-26

### Fixed

- **Signature Pad**
  - Fix issue where hidden input throws a controlled warning in React due to the absence of `readOnly` or `onChange`.
  - Fix issue where calling `getDataUrl` in the `onDrawEnd` callback after clearing the signature pad does not return an
    empty string.

- **React**: Improve Hot Module Replacement such that effects are replayed correctly. This removes the need to refresh
  the page for changes to take effect.

- **Toggle Group**: Fix issue where calling `api.setValue` with an array doesn't work as expected.

- **Pin Input**: Fix `flushSync was called from inside a lifecycle method` warning.

- **Vue**: Fix issue where `choose is not a function` error could be thrown for some machines.

- **File Upload**: Fix issue where `win.DataTransfer` could throw in testing environments.

- **Time Picker**: Fix `[@zag-js/dismissable] node is null or undefined` warning when lazy mounting the content.

### Added

- **Pin Input**: Add support for `count` prop to improve SSR `aria-label` attribute.

## [1.1.0](./#1.1.0) - 2025-02-26

### Fixed

- **Pin Input**: Fix issue where editing existing values don't work as expected.

- **Number Input**: Fix issue where `value` prop wasn't consumed in the machine.

- **Carousel**: Fix issue where `page` was not consumed in the machine.

- **Textarea**: Fix issue where `ResizeObserver` loop could throw undelivered notifications warning.

### Added

- **Toggle**: Bring back toggle machine.

- **Hover Card**: Expose interaction outside handlers to hover card.

## [1.0.2](./#1.0.2) - 2025-02-24

### Fixed

- **Collection**: Widen `items` type to allow `Iterable` instead of just `Array` since we internally convert iterables
  to an array.

- **Carousel**: Enforce required `slideCount` to ensure machine works as expected.

- **Framework Bindings**: Fix issue where `undefined` values were not filtered out before resolving props.

- **React**: Fix issue where `flushSync` warnings could be shown when unmounting a component.

## [1.0.1](./#1.0.1) - 2025-02-23

### Fixed

- **Select**: Fix regression where `multiple: true` doesn't work.

- **Timer**: Fix issue where timer doesn't restart when `startMs` changes.

- **Toggle Group**: Fix issue where `data-focus` doesn't get removed after blurring the toggle group.

- **Toast**: Fix keyboard navigation issue where toast group skips the close button within the toast item and moves to
  the next focusable element in the document.

### Added

- Added `<component>.Machine` type to help when typecasting generic components like combobox and select.

## [1.0.0](./#1.0.0) - 2025-02-22

### Changed

- **Core**: Rewrite machines for increased performance and initial mount time. The results show roughly 1.5x - 4x
  performance improvements across components.

- **[Breaking] Toast**
  - Require the creation of a toast store using `createStore`
  - **Solid.js**: Require the usage of `<Key>` component to render toasts

### Fixed

- **Menu**: Fix issue where context menu doesn't update positioning on subsequent right clicks.

- **Avatar**: Fix issue where `api.setSrc` doesn't work.

- **File Upload**: Fix issue where drag-and-drop doesn't work when `directory` is `true`.

- **Carousel**
  - Fix issue where initial page is not working.
  - Fix issue where pagination sync broken after using dots indicators.

- **Timer**: Fix issue where timer stops when switching tabs.