[rohanchkrabrty]

Summary

• Breaking: state props use x, defaultX and onXChange. Select searchValue, defaultSearchValue, onSearch become inputValue, defaultInputValue, onInputValueChange. DatePicker and RangePicker onSelect becomes onValueChange. Tour onStepChange becomes onStepIndexChange, with the step in details.step. DataView onTableQueryChange becomes onQueryChange.
• Breaking: DataView query and FilterChip value were read on the first render only. They are now controlled with Base UI useControlled, and defaultQuery and defaultValue set the first value. DatePicker value also moves to useControlled.
• FilterChip adds operation and defaultOperation. DataView passes each filter's operator to its chip, so a query with operator: 'neq' shows "is not".
• Every new callback follows feat: pass a details object to change callbacks #979: Select forwards Base UI eventDetails. DatePicker, RangePicker, Tour, DataView and FilterChip onOperationChange pass details from createChangeDetails.
• Docs: props tables, demos, mdx pages, the upgrading page, the consumer skill and the FilterChip Code Connect template. Tests cover the renames, the controlled DataView query, FilterChip value and operation, and a controlled DatePicker.

Stacked on #979. Retarget to main after it merges.

• I have followed the pull request section of the contributing guide.

Decisions

• FilterChip reports an operation change through the existing onOperationChange, now (operation, details). onValueChange keeps details.operation from feat: pass a details object to change callbacks #979. The details.reason comes from the operation Select.
• DataView keeps its internal query, because the wire query leaves out filters with no value. A query from outside replaces it only when the two differ, so a new empty filter chip stays. A query change from outside does not call onQueryChange.
• DataView calls onQueryChange in client mode too, so a controlled query works in both modes. Server mode still calls it on mount, as onTableQueryChange did. details.reason is none, because the call runs after the state change.
• DatePicker still commits a typed date on Enter, blur or an outside click. It now calls onValueChange only when the typed date differs from the value. A day click passes reason item-press and a typed date passes input-change.
• defaultOperation falls back to the first operation, as before. FilterChip keeps the typed text of a number column, so 1. and - stay editable under a controlled value.
• docs/rfcs/003 and docs/V1-migration.md keep the old names, since they record earlier releases. DataTable keeps query and onTableQueryChange.

Overlap with open PRs

• refactor: use base ui useControlled for controlled state #966 converts Select value and searchValue, RangePicker value and DataView view to useControlled. This PR does not redo that. It only renames Select's props and keeps RangePicker's mirror, so expect conflicts in select-root.tsx, range-picker.tsx and data-view.tsx.
• fix: [combobox] filter items by inputValue and defaultInputValue #967 and fix: [select] pass searchValue to the autocomplete search input #968 pass Combobox and Select inputValue to the Base UI Combobox. fix: [select] pass searchValue to the autocomplete search input #968 does it for Select under the old searchValue name, so it needs the new names after this PR.
• The upgrading page gets a new section, so it can conflict with other PRs that add one.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
apsara	Ready	Preview	Oct 19, 2026 9:25pm UTC

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: 285848b8-4242-4273-8ea0-412ae0fc3922

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[pkg-pr-new]

Open in StackBlitz

pnpm add https://pkg.pr.new/@raystack/apsara@983

commit: d7c976e