[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, and value={null} is a controlled empty date.
• 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

• Each callback this PR adds or renames runs before the state update, as in feat: pass a details object to change callbacks #979. Select skips the update when eventDetails.isCanceled.
• 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. A copy of the reported query, for example a JSON copy from the URL, counts as the same query, 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 once on mount, as onTableQueryChange did, also under StrictMode. details.reason is none, because the call runs after the state change.
• A controlled DataView query follows React's controlled rule: if the parent does not pass the new query back, the view returns to the query prop.
• 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.

Builds on merged PRs

• refactor: use base ui useControlled for controlled state #966 moved Select value and searchValue, RangePicker value and DataView view to useControlled. This PR renames Select's searchValue state to inputValue and keeps refactor: use base ui useControlled for controlled state #966's useControlled for RangePicker.
• fix: [select] pass searchValue to the autocomplete search input #968 passes Select's search text to the Base UI Combobox. This PR renames that code too, so Select passes inputValue, defaultInputValue and onInputValueChange to Base UI.
• fix: [combobox] filter items by inputValue and defaultInputValue #967 already uses inputValue on Combobox, so it needs no change.
• 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 22, 2026 5:08am 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: 467109c2-eb39-4817-8de3-f84cfa17662c

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: de53b19