Description

Issue

• DataTable used TanStack Table’s default row identity (array index).
  With sorting, grouping, or filtering, rows could get wrong React keys and cause rendering issues.

Usage

<DataTable
    data={data}
    columns={memoizedColumns}
    getRowId={row => row.id}
  >
    <DataTable.Toolbar />
    <DataTable.Search />
    <DataTable.Content />
</DataTable>

Fix

• New optional prop: getRowId?: (row: TData, index: number) => string.
  It’s passed through as TanStack’s getRowId, so each row can have a stable key (e.g. getRowId={row => row.id}).
• Docs and tests updated to use getRowId.

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactor (no functional changes, no bug fixes just code improvements)
• Chore (changes to the build process or auxiliary tools and libraries such as documentation generation)
• Style (changes that do not affect the meaning of the code (white-space, formatting, etc))
• Test (adding missing tests or correcting existing tests)
• Improvement (Improvements to existing code)
• Other (please specify)

How Has This Been Tested?

[Describe the tests that you ran to verify your changes]

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (.mdx files)
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works

Screenshots (if appropriate):

[Add screenshots here]

Related Issues

[Link any related issues here using #issue-number]

Summary by CodeRabbit

• New Features

  • DataTable supports an optional custom row-id callback for stable row keys in sortable/filterable tables.

• Documentation

  • Clarified column configuration guidance for performance (stable columns reference).
  • Added guidance to provide stable row IDs to avoid rendering issues when rows reorder.

• Tests

  • Added tests verifying stable row keys and correct rendering when a row-id callback is provided.