fix sorting replacement in single-sort mode

[KevinVandy]

What changed

• distinguish actual multi-sort actions from single-sort actions
• when an existing column is toggled without multi-sort, reduce the sorting state to that column
• preserve the normal toggle/remove cycle while discarding the other multi-sort entries
• add a regression test for toggling the last column of an existing multi-sort state

Why

toggleSorting(..., false) previously kept the other sorted columns when the target column was already the final entry. The action was classified as a toggle, and the toggle path mapped over the entire previous state.

Single-sort actions should leave at most the selected column in the sorting state, regardless of its prior position.

Validation

• packages/table-core/tests/unit/features/row-sorting/rowSortingFeature.utils.test.ts — 47 tests passed
• Prettier and git diff --check

Closes #4309

[coderabbitai]

Important

Review skipped

Draft detected.

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

Review profile: CHILL

Plan: Pro

Run ID: d779aedd-95d9-4c91-8dbc-82af5b87226f

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch agent/fix-4309-single-sort

---

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.}

[nx-cloud]

View your CI Pipeline Execution ↗ for commit d2fb560

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:sherif,t...	✅ Succeeded	8m 46s	View ↗
nx run-many --targets=build --exclude=examples/**	✅ Succeeded	54s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-07-17 20:28:33 UTC

[pkg-pr-new]

More templates

• tanstack-alpine-table-example-aggregation
• tanstack-alpine-table-example-basic-app-table
• tanstack-alpine-table-example-basic-create-table
• tanstack-alpine-table-example-basic-dynamic-columns
• tanstack-alpine-table-example-basic-external-atoms
• tanstack-alpine-table-example-basic-external-state
• tanstack-alpine-table-example-column-ordering
• tanstack-alpine-table-example-column-pinning
• tanstack-alpine-table-example-column-pinning-split
• tanstack-alpine-table-example-column-pinning-sticky
• tanstack-alpine-table-example-column-resizing
• tanstack-alpine-table-example-column-resizing-performant
• tanstack-alpine-table-example-column-sizing
• tanstack-alpine-table-example-column-visibility
• tanstack-alpine-table-example-custom-plugin
• tanstack-alpine-table-example-expanding
• tanstack-alpine-table-example-filters
• tanstack-alpine-table-example-filters-faceted
• tanstack-alpine-table-example-grouped-aggregation
• tanstack-alpine-table-example-grouping
• tanstack-alpine-table-example-header-groups
• tanstack-alpine-table-example-pagination
• tanstack-alpine-table-example-row-pinning
• tanstack-alpine-table-example-row-selection
• tanstack-alpine-table-example-sorting
• tanstack-alpine-table-example-sorting-dynamic-data
• tanstack-alpine-table-example-sub-components
• tanstack-ember-table-example-aggregation
• tanstack-ember-table-example-basic-app-table
• tanstack-ember-table-example-basic-external-atoms
• tanstack-ember-table-example-basic-external-state
• tanstack-ember-table-example-basic-table
• tanstack-ember-table-example-column-ordering
• tanstack-ember-table-example-column-pinning
• tanstack-ember-table-example-column-pinning-split
• tanstack-ember-table-example-column-pinning-sticky
• tanstack-ember-table-example-column-resizing
• tanstack-ember-table-example-column-resizing-performant
• tanstack-ember-table-example-column-sizing
• tanstack-ember-table-example-column-visibility
• tanstack-ember-table-example-custom-plugin
• tanstack-ember-table-example-editable
• tanstack-ember-table-example-expanding
• tanstack-ember-table-example-filters
• tanstack-ember-table-example-filters-faceted
• tanstack-ember-table-example-filters-fuzzy
• tanstack-ember-table-example-grouped-aggregation
• tanstack-ember-table-example-grouping
• tanstack-ember-table-example-header-groups
• tanstack-ember-table-example-kitchen-sink
• tanstack-ember-table-example-pagination
• tanstack-ember-table-example-remote-data
• tanstack-ember-table-example-row-dnd
• tanstack-ember-table-example-row-pinning
• tanstack-ember-table-example-row-selection
• tanstack-ember-table-example-sorting
• tanstack-ember-table-example-sub-components
• tanstack-angular-table-example-aggregation
• tanstack-angular-table-example-basic-app-table
• tanstack-angular-table-example-basic-dynamic-columns
• tanstack-angular-table-example-basic-external-atoms
• tanstack-angular-table-example-basic-external-state
• tanstack-angular-table-example-basic-inject-table
• tanstack-angular-table-example-column-ordering
• tanstack-angular-table-example-column-pinning
• tanstack-angular-table-example-column-pinning-split
• tanstack-angular-table-example-column-pinning-sticky
• tanstack-angular-table-example-column-resizing
• tanstack-angular-table-example-column-resizing-performant
• tanstack-angular-table-example-column-sizing
• tanstack-angular-table-example-column-visibility
• tanstack-angular-table-example-composable-tables
• tanstack-angular-table-example-custom-plugin
• tanstack-angular-table-example-editable
• tanstack-angular-table-example-expanding
• tanstack-angular-table-example-filters
• tanstack-angular-table-example-filters-faceted
• tanstack-angular-table-example-filters-fuzzy
• tanstack-angular-table-example-grouped-aggregation
• tanstack-angular-table-example-grouping
• tanstack-angular-table-example-header-groups
• tanstack-angular-table-example-kitchen-sink
• tanstack-angular-table-example-pagination
• tanstack-angular-table-example-remote-data
• tanstack-angular-table-example-row-dnd
• tanstack-angular-table-example-row-pinning
• tanstack-angular-table-example-row-selection
• tanstack-angular-table-example-row-selection-signal
• tanstack-angular-table-example-signal-input
• tanstack-angular-table-example-sorting
• tanstack-angular-table-example-sub-components
• tanstack-angular-table-example-virtualized-columns
• tanstack-angular-table-example-virtualized-infinite-scrolling
• tanstack-angular-table-example-virtualized-rows
• tanstack-angular-table-example-with-tanstack-form
• tanstack-angular-table-example-with-tanstack-query
• tanstack-lit-table-example-aggregation
• tanstack-lit-table-example-basic-app-table
• tanstack-lit-table-example-basic-dynamic-columns
• tanstack-lit-table-example-basic-external-atoms
• tanstack-lit-table-example-basic-external-state
• tanstack-lit-table-example-basic-subscribe
• tanstack-lit-table-example-basic-table-controller
• tanstack-lit-table-example-column-ordering
• tanstack-lit-table-example-column-pinning
• tanstack-lit-table-example-column-pinning-split
• tanstack-lit-table-example-column-pinning-sticky
• tanstack-lit-table-example-column-resizing
• tanstack-lit-table-example-column-resizing-performant
• tanstack-lit-table-example-column-sizing
• tanstack-lit-table-example-column-visibility
• tanstack-lit-table-example-composable-tables
• tanstack-lit-table-example-expanding
• tanstack-lit-table-example-filters
• tanstack-lit-table-example-filters-faceted
• tanstack-lit-table-example-filters-fuzzy
• tanstack-lit-table-example-grouped-aggregation
• tanstack-lit-table-example-grouping
• tanstack-lit-table-example-header-groups
• tanstack-lit-table-example-kitchen-sink
• tanstack-lit-table-example-pagination
• tanstack-lit-table-example-row-pinning
• tanstack-lit-table-example-row-selection
• tanstack-lit-table-example-sorting
• tanstack-lit-table-example-sorting-dynamic-data
• tanstack-lit-table-example-sub-components
• tanstack-lit-table-example-virtualized-columns
• tanstack-lit-table-example-virtualized-infinite-scrolling
• tanstack-lit-table-example-virtualized-rows
• tanstack-preact-table-example-aggregation
• tanstack-preact-table-example-basic-dynamic-columns
• tanstack-preact-table-example-basic-external-atoms
• tanstack-preact-table-example-basic-external-state
• tanstack-preact-table-example-basic-subscribe
• tanstack-preact-table-example-basic-use-app-table
• tanstack-preact-table-example-basic-use-table
• tanstack-preact-table-example-column-ordering
• tanstack-preact-table-example-column-pinning
• tanstack-preact-table-example-column-pinning-split
• tanstack-preact-table-example-column-pinning-sticky
• tanstack-preact-table-example-column-resizing
• tanstack-preact-table-example-column-resizing-performant
• tanstack-preact-table-example-column-sizing
• tanstack-preact-table-example-column-visibility
• tanstack-preact-table-example-composable-tables
• tanstack-preact-table-example-custom-plugin
• tanstack-preact-table-example-expanding
• tanstack-preact-table-example-filters
• tanstack-preact-table-example-filters-faceted
• tanstack-preact-table-example-filters-fuzzy
• tanstack-preact-table-example-grouped-aggregation
• tanstack-preact-table-example-grouping
• tanstack-preact-table-example-header-groups
• tanstack-preact-table-example-kitchen-sink
• tanstack-preact-table-example-pagination
• tanstack-preact-table-example-row-pinning
• tanstack-preact-table-example-row-selection
• tanstack-preact-table-example-sorting
• tanstack-preact-table-example-sub-components
• tanstack-preact-table-example-with-tanstack-form
• tanstack-preact-table-example-with-tanstack-query
• tanstack-react-table-example-aggregation
• tanstack-react-table-example-basic-dynamic-columns
• tanstack-react-table-example-basic-external-atoms
• tanstack-react-table-example-basic-external-state
• tanstack-react-table-example-basic-subscribe
• tanstack-react-table-example-basic-use-app-table
• tanstack-react-table-example-basic-use-legacy-table
• tanstack-react-table-example-basic-use-table
• tanstack-react-table-example-column-dnd
• tanstack-react-table-example-column-ordering
• tanstack-react-table-example-column-pinning
• tanstack-react-table-example-column-pinning-split
• tanstack-react-table-example-column-pinning-sticky
• tanstack-react-table-example-column-resizing
• tanstack-react-table-example-column-resizing-performant
• tanstack-react-table-example-column-sizing
• tanstack-react-table-example-column-visibility
• tanstack-react-table-example-composable-tables
• tanstack-react-table-example-custom-plugin
• tanstack-react-table-example-expanding
• tanstack-react-table-example-filters
• tanstack-react-table-example-filters-faceted
• tanstack-react-table-example-filters-fuzzy
• tanstack-react-table-example-grouped-aggregation
• tanstack-react-table-example-grouping
• tanstack-react-table-example-header-groups
• tanstack-react-table-example-kitchen-sink
• tanstack-react-table-example-kitchen-sink-chakra-ui
• tanstack-react-table-example-kitchen-sink-hero-ui
• tanstack-react-table-example-kitchen-sink-mantine
• tanstack-react-table-example-kitchen-sink-material-ui
• tanstack-react-table-example-kitchen-sink-react-aria
• tanstack-react-table-example-kitchen-sink-shadcn-base
• tanstack-react-table-example-kitchen-sink-shadcn-radix
• tanstack-react-table-example-lib-chakra-ui
• tanstack-react-table-example-lib-hero-ui
• tanstack-react-table-example-lib-mantine
• tanstack-react-table-example-lib-material-ui
• tanstack-react-table-example-lib-react-aria
• tanstack-react-table-example-lib-shadcn-base
• tanstack-react-table-example-lib-shadcn-radix
• tanstack-react-table-example-mantine-react-table
• tanstack-react-table-example-material-react-table
• tanstack-react-table-example-pagination
• tanstack-react-table-example-row-dnd
• tanstack-react-table-example-row-pinning
• tanstack-react-table-example-row-selection
• tanstack-react-table-example-sorting
• tanstack-react-table-example-sub-components
• tanstack-react-table-example-virtualized-columns
• tanstack-react-table-example-virtualized-columns-experimental
• tanstack-react-table-example-virtualized-infinite-scrolling
• tanstack-react-table-example-virtualized-rows
• tanstack-react-table-example-virtualized-rows-experimental
• tanstack-react-table-example-web-worker-row-models
• tanstack-react-table-example-with-tanstack-form
• tanstack-react-table-example-with-tanstack-query
• tanstack-react-table-example-with-tanstack-router
• tanstack-solid-table-example-aggregation
• tanstack-solid-table-example-basic-app-table
• tanstack-solid-table-example-basic-dynamic-columns
• tanstack-solid-table-example-basic-external-atoms
• tanstack-solid-table-example-basic-external-state
• tanstack-solid-table-example-basic-use-table
• tanstack-solid-table-example-column-ordering
• tanstack-solid-table-example-column-pinning
• tanstack-solid-table-example-column-pinning-split
• tanstack-solid-table-example-column-pinning-sticky
• tanstack-solid-table-example-column-resizing
• tanstack-solid-table-example-column-resizing-performant
• tanstack-solid-table-example-column-sizing
• tanstack-solid-table-example-column-visibility
• tanstack-solid-table-example-composable-tables
• tanstack-solid-table-example-expanding
• tanstack-solid-table-example-filters
• tanstack-solid-table-example-filters-faceted
• tanstack-solid-table-example-filters-fuzzy
• tanstack-solid-table-example-grouped-aggregation
• tanstack-solid-table-example-grouping
• tanstack-solid-table-example-header-groups
• tanstack-solid-table-example-kitchen-sink
• tanstack-solid-table-example-pagination
• tanstack-solid-table-example-row-pinning
• tanstack-solid-table-example-row-selection
• tanstack-solid-table-example-sorting
• tanstack-solid-table-example-sub-components
• tanstack-solid-table-example-virtualized-columns
• tanstack-solid-table-example-virtualized-infinite-scrolling
• tanstack-solid-table-example-virtualized-rows
• tanstack-solid-table-example-with-tanstack-form
• tanstack-solid-table-example-with-tanstack-query
• tanstack-solid-table-example-with-tanstack-router
• tanstack-vanilla-table-example-aggregation
• tanstack-vanilla-table-example-basic
• tanstack-vanilla-table-example-pagination
• tanstack-vanilla-table-example-sorting
• tanstack-svelte-table-example-aggregation
• tanstack-svelte-table-example-basic-app-table
• tanstack-svelte-table-example-basic-create-table
• tanstack-svelte-table-example-basic-dynamic-columns
• tanstack-svelte-table-example-basic-external-atoms
• tanstack-svelte-table-example-basic-external-state
• tanstack-svelte-table-example-basic-snippets
• tanstack-svelte-table-example-column-ordering
• tanstack-svelte-table-example-column-pinning
• tanstack-svelte-table-example-column-pinning-split
• tanstack-svelte-table-example-column-pinning-sticky
• tanstack-svelte-table-example-column-resizing
• tanstack-svelte-table-example-column-resizing-performant
• tanstack-svelte-table-example-column-sizing
• tanstack-svelte-table-example-column-visibility
• tanstack-svelte-table-example-composable-tables
• tanstack-svelte-table-example-expanding
• tanstack-svelte-table-example-filtering
• tanstack-svelte-table-example-filters-faceted
• tanstack-svelte-table-example-filters-fuzzy
• tanstack-svelte-table-example-grouped-aggregation
• tanstack-svelte-table-example-grouping
• tanstack-svelte-table-example-header-groups
• tanstack-svelte-table-example-kitchen-sink
• tanstack-svelte-table-example-pagination
• tanstack-svelte-table-example-row-pinning
• tanstack-svelte-table-example-row-selection
• tanstack-svelte-table-example-sorting
• tanstack-svelte-table-example-sub-components
• tanstack-svelte-table-example-virtualized-columns
• tanstack-svelte-table-example-virtualized-infinite-scrolling
• tanstack-svelte-table-example-virtualized-rows
• tanstack-svelte-table-example-with-tanstack-form
• tanstack-svelte-table-example-with-tanstack-query
• tanstack-vue-table-example-aggregation
• tanstack-vue-table-example-basic-dynamic-columns
• tanstack-vue-table-example-basic-external-atoms
• tanstack-vue-table-example-basic-external-state
• tanstack-vue-table-example-basic-use-app-table
• tanstack-vue-table-example-basic-use-table
• tanstack-vue-table-example-column-ordering
• tanstack-vue-table-example-column-pinning
• tanstack-vue-table-example-column-pinning-split
• tanstack-vue-table-example-column-pinning-sticky
• tanstack-vue-table-example-column-resizing
• tanstack-vue-table-example-column-resizing-performant
• tanstack-vue-table-example-column-sizing
• tanstack-vue-table-example-column-visibility
• tanstack-vue-table-example-composable-tables
• tanstack-vue-table-example-expanding
• tanstack-vue-table-example-filters
• tanstack-vue-table-example-filters-faceted
• tanstack-vue-table-example-filters-fuzzy
• tanstack-vue-table-example-grouped-aggregation
• tanstack-vue-table-example-grouping
• tanstack-vue-table-example-header-groups
• tanstack-vue-table-example-kitchen-sink
• tanstack-vue-table-example-pagination
• tanstack-vue-table-example-row-pinning
• tanstack-vue-table-example-row-selection
• tanstack-vue-table-example-sorting
• tanstack-vue-table-example-sub-components
• tanstack-vue-table-example-virtualized-columns
• tanstack-vue-table-example-virtualized-infinite-scrolling
• tanstack-vue-table-example-virtualized-rows
• tanstack-vue-table-example-with-tanstack-form
• tanstack-vue-table-example-with-tanstack-query

@tanstack/alpine-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/alpine-table@6431

@tanstack/angular-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/angular-table@6431

@tanstack/angular-table-devtools

npm i https://pkg.pr.new/TanStack/table/@tanstack/angular-table-devtools@6431

@tanstack/ember-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/ember-table@6431

@tanstack/lit-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/lit-table@6431

@tanstack/match-sorter-utils

npm i https://pkg.pr.new/TanStack/table/@tanstack/match-sorter-utils@6431

@tanstack/preact-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/preact-table@6431

@tanstack/preact-table-devtools

npm i https://pkg.pr.new/TanStack/table/@tanstack/preact-table-devtools@6431

@tanstack/react-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/react-table@6431

@tanstack/react-table-devtools

npm i https://pkg.pr.new/TanStack/table/@tanstack/react-table-devtools@6431

@tanstack/solid-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/solid-table@6431

@tanstack/solid-table-devtools

npm i https://pkg.pr.new/TanStack/table/@tanstack/solid-table-devtools@6431

@tanstack/svelte-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/svelte-table@6431

@tanstack/table-core

npm i https://pkg.pr.new/TanStack/table/@tanstack/table-core@6431

@tanstack/table-devtools

npm i https://pkg.pr.new/TanStack/table/@tanstack/table-devtools@6431

@tanstack/vue-table

npm i https://pkg.pr.new/TanStack/table/@tanstack/vue-table@6431

@tanstack/vue-table-devtools

npm i https://pkg.pr.new/TanStack/table/@tanstack/vue-table-devtools@6431

commit: d2fb560