feat(mui): Add configurable filter debouncing to useDataGrid hook

[Alex-Murmu]

• Add filterDebounceMs option (default: 500ms)
• Add filterDebounceMode option ('smart', 'all', 'off')
• Add onFilterDebounceStart and onFilterDebounceEnd callbacks
• Add isPendingFilters state tracking
• Smart mode debounces only text filters
• Fixes useDataGrid sends API requests on every keystroke causing performance issues and race conditions #7369

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://refine.dev/docs/guides-concepts/contributing/#commit-convention

Bugs / Features

• Related issue(s) linked
• Tests for the changes have been added
• Docs have been added / updated
• Changesets have been added https://refine.dev/docs/guides-concepts/contributing/#creating-a-changeset

What is the current behavior?

The useDataGrid hook sends API requests on every filter change, including every keystroke in text filters. This causes:

• API flooding with unnecessary requests
• Race conditions when responses arrive out of order
• Lost characters when typing quickly
• Poor UX on slow connections

Related to issue #7369

What is the new behavior?

Added configurable, smart filter debouncing:

1. New filterDebounceMs option (default: 500ms) - Controls debounce delay
2. New filterDebounceMode option - Three modes:
   • 'smart' (default): Only debounce text filters (contains, startswith), apply categorical filters (eq, in) immediately
   • 'all': Debounce all filter changes
   • 'off': No debouncing
3. New callbacks: onFilterDebounceStart and onFilterDebounceEnd for loading states
4. New isPendingFilters state: Track when filters are being debounced

Example Usage

const { dataGridProps, isPendingFilters } = useDataGrid({
  resource: 'users',
  filterDebounceMs: 500,
  filterDebounceMode: 'smart',
});

return (
  <>
    {isPendingFilters && <CircularProgress />}
    <DataGrid {...dataGridProps} />
  </>
);

[changeset-bot]

🦋 Changeset detected

Latest commit: 0c927f5

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@refinedev/mui	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[Copilot]

Pull request overview

Adds configurable, mode-based debouncing for server-side filter updates in the @refinedev/mui useDataGrid hook to reduce request flooding and improve typing UX (issue #7369).

Changes:

• Introduces filterDebounceMs, filterDebounceMode (smart/all/off), debounce lifecycle callbacks, and isPendingFilters state to useDataGrid.
• Updates server-side onFilterModelChange handling to debounce filter application based on mode.
• Also bumps monorepo tooling deps (lerna, nx, vitest) and relaxes typing in Appwrite sorting utility.

Reviewed changes

Copilot reviewed 3 out of 5 changed files in this pull request and generated 9 comments.

File	Description
packages/mui/src/hooks/useDataGrid/index.ts	Adds new hook options/state and implements debounced server-side filter application logic.
packages/appwrite/src/utils/getAppwriteSorting.ts	Changes sorter iteration typing (introduces any) in Appwrite query sorting helper.
package.json	Upgrades dev tooling dependencies (lerna/nx/vitest).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Alex-Murmu]

Q