Selection

{"prompt":"You are comparing an AI-suggested code fix with actual changes made in a commit.\n\nYour task: Determine if the commit contains the essence of the AI fix and provide a confidence level.\n\n## AI-Suggested Fix\n\n**What it fixes:** @tanstack/table-core:test:lib\n\n**Description:** fix(table-core): skip drag when no document is passed to handler\n\n**Reasoning:** The `cell_getSelectionStartHandler` function accepted an optional `_contextDocument` parameter and fell back to the global `document` when none was supplied:\n\n```ts\nconst contextDocument =\n _contextDocument ?? (typeof document !== 'undefined' ? document : null)\n```\n\nIn a real browser this is convenient, but the PR's test suite explicitly verifies that drag state (`_isSelectingCells`) must NOT be opened unless a document is passed in — because without a handle to the document there is no way to \n\n**Suggested Changes (diff):**\n```diff\ndiff --git a/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts b/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts\nindex 41b2a0c8..c0039022 100644\n--- a/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts\n+++ b/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts\n@@ -1077,8 +1077,7 @@ export function cell_getSelectionStartHandler<\n \n const table = cell.table\n const options = table.options\n- const contextDocument =\n- _contextDocument ?? (typeof document !== 'undefined' ? document : null)\n+ const contextDocument = _contextDocument ?? null\n \n const isRangeEvent =\n options.enableCellRangeSelection !== false &&\n\n```\n\n## Actual Commit Changes\n\n**Commit Diff:**\n```diff\ndiff --git a/docs/config.json b/docs/config.json\nindex 3434e6e53b..cfcd521771 100644\n--- a/docs/config.json\n+++ b/docs/config.json\n@@ -201,6 +201,7 @@\n {\n \"label\": \"alpine\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/alpine/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/alpine/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/alpine/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/alpine/guide/column-sizing\" },\n@@ -215,7 +216,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/alpine/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/alpine/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/alpine/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/alpine/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/alpine/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/alpine/guide/sorting\" }\n ]\n@@ -223,6 +223,7 @@\n {\n \"label\": \"angular\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/angular/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/angular/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/angular/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/angular/guide/column-sizing\" },\n@@ -237,7 +238,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/angular/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/angular/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/angular/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/angular/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/angular/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/angular/guide/sorting\" },\n { \"label\": \"Virtualization\", \"to\": \"framework/angular/guide/virtualization\" }\n@@ -246,6 +246,7 @@\n {\n \"label\": \"ember\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/ember/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/ember/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/ember/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/ember/guide/column-sizing\" },\n@@ -260,7 +261,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/ember/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/ember/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/ember/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/ember/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/ember/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/ember/guide/sorting\" }\n ]\n@@ -268,6 +268,7 @@\n {\n \"label\": \"lit\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/lit/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/lit/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/lit/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/lit/guide/column-sizing\" },\n@@ -282,7 +283,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/lit/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/lit/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/lit/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/lit/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/lit/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/lit/guide/sorting\" },\n { \"label\": \"Virtualization\", \"to\": \"framework/lit/guide/virtualization\" }\n@@ -291,6 +291,7 @@\n {\n \"label\": \"react\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/react/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/react/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/react/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/react/guide/column-sizing\" },\n@@ -305,7 +306,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/react/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/react/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/react/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/react/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/react/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/react/guide/sorting\" },\n { \"label\": \"Virtualization\", \"to\": \"framework/react/guide/virtualization\" }\n@@ -314,6 +314,7 @@\n {\n \"label\": \"preact\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/preact/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/preact/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/preact/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/preact/guide/column-sizing\" },\n@@ -328,7 +329,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/preact/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/preact/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/preact/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/preact/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/preact/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/preact/guide/sorting\" },\n { \"label\": \"Virtualization\", \"to\": \"framework/preact/guide/virtualization\" }\n@@ -337,6 +337,7 @@\n {\n \"label\": \"solid\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/solid/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/solid/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/solid/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/solid/guide/column-sizing\" },\n@@ -351,7 +352,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/solid/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/solid/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/solid/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/solid/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/solid/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/solid/guide/sorting\" },\n { \"label\": \"Virtualization\", \"to\": \"framework/solid/guide/virtualization\" }\n@@ -360,6 +360,7 @@\n {\n \"label\": \"svelte\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/svelte/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/svelte/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/svelte/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/svelte/guide/column-sizing\" },\n@@ -374,7 +375,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/svelte/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/svelte/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/svelte/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/svelte/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/svelte/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/svelte/guide/sorting\" },\n { \"label\": \"Virtualization\", \"to\": \"framework/svelte/guide/virtualization\" }\n@@ -383,6 +383,7 @@\n {\n \"label\": \"vue\",\n \"children\": [\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/vue/guide/cell-selection\" },\n { \"label\": \"Column Ordering\", \"to\": \"framework/vue/guide/column-ordering\" },\n { \"label\": \"Column Pinning\", \"to\": \"framework/vue/guide/column-pinning\" },\n { \"label\": \"Column Sizing\", \"to\": \"framework/vue/guide/column-sizing\" },\n@@ -397,7 +398,6 @@\n { \"label\": \"Expanding\", \"to\": \"framework/vue/guide/expanding\" },\n { \"label\": \"Pagination\", \"to\": \"framework/vue/guide/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/vue/guide/row-pinning\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/vue/guide/cell-selection\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/vue/guide/row-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/vue/guide/sorting\" },\n { \"label\": \"Virtualization\", \"to\": \"framework/vue/guide/virtualization\" }\n@@ -1069,6 +1069,7 @@\n {\n \"label\": \"alpine\",\n \"children\": [\n+ { \"to\": \"framework/alpine/examples/cell-selection\", \"label\": \"Cell Selection\" },\n { \"to\": \"framework/alpine/examples/filters\", \"label\": \"Column Filters\" },\n { \"to\": \"framework/alpine/examples/filters-faceted\", \"label\": \"Column Filters (Faceted)\" },\n { \"to\": \"framework/alpine/examples/filters-faceted-bucketed\", \"label\": \"Bucketed Faceted Filters\" },\n@@ -1088,7 +1089,6 @@\n { \"to\": \"framework/alpine/examples/pagination\", \"label\": \"Pagination\" },\n { \"to\": \"framework/alpine/examples/row-pinning\", \"label\": \"Row Pinning\" },\n { \"to\": \"framework/alpine/examples/row-selection\", \"label\": \"Row Selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/alpine/examples/cell-selection\" },\n { \"to\": \"framework/alpine/examples/sorting\", \"label\": \"Sorting\" },\n { \"to\": \"framework/alpine/examples/sorting-dynamic-data\", \"label\": \"Sorting (Dynamic Data)\" }\n ]\n@@ -1097,6 +1097,7 @@\n \"label\": \"angular\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/angular/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/angular/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/angular/examples/filters\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/angular/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/angular/examples/filters-faceted-bucketed\" },\n@@ -1117,7 +1118,6 @@\n { \"label\": \"Pagination\", \"to\": \"framework/angular/examples/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/angular/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/angular/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/angular/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/angular/examples/sorting\" }\n ]\n },\n@@ -1125,6 +1125,7 @@\n \"label\": \"ember\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/ember/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/ember/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/ember/examples/filters\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/ember/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/ember/examples/filters-faceted-bucketed\" },\n@@ -1145,7 +1146,6 @@\n { \"label\": \"Pagination\", \"to\": \"framework/ember/examples/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/ember/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/ember/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/ember/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/ember/examples/sorting\" }\n ]\n },\n@@ -1153,6 +1153,7 @@\n \"label\": \"lit\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/lit/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/lit/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/lit/examples/filters\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/lit/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/lit/examples/filters-faceted-bucketed\" },\n@@ -1173,7 +1174,6 @@\n { \"label\": \"Pagination\", \"to\": \"framework/lit/examples/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/lit/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/lit/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/lit/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/lit/examples/sorting\" },\n { \"label\": \"Sorting (Dynamic Data)\", \"to\": \"framework/lit/examples/sorting-dynamic-data\" }\n ]\n@@ -1182,6 +1182,7 @@\n \"label\": \"react\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/react/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/react/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/react/examples/filters\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/react/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/react/examples/filters-faceted-bucketed\" },\n@@ -1204,7 +1205,6 @@\n { \"label\": \"Row DnD\", \"to\": \"framework/react/examples/row-dnd\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/react/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/react/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/react/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/react/examples/sorting\" }\n ]\n },\n@@ -1212,6 +1212,7 @@\n \"label\": \"solid\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/solid/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/solid/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/solid/examples/filters\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/solid/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/solid/examples/filters-faceted-bucketed\" },\n@@ -1232,7 +1233,6 @@\n { \"label\": \"Pagination\", \"to\": \"framework/solid/examples/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/solid/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/solid/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/solid/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/solid/examples/sorting\" }\n ]\n },\n@@ -1240,6 +1240,7 @@\n \"label\": \"svelte\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/svelte/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/svelte/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/svelte/examples/filtering\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/svelte/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/svelte/examples/filters-faceted-bucketed\" },\n@@ -1260,7 +1261,6 @@\n { \"label\": \"Pagination\", \"to\": \"framework/svelte/examples/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/svelte/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/svelte/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/svelte/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/svelte/examples/sorting\" }\n ]\n },\n@@ -1268,6 +1268,7 @@\n \"label\": \"vue\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/vue/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/vue/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/vue/examples/filters\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/vue/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/vue/examples/filters-faceted-bucketed\" },\n@@ -1288,7 +1289,6 @@\n { \"label\": \"Pagination\", \"to\": \"framework/vue/examples/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/vue/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/vue/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/vue/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/vue/examples/sorting\" }\n ]\n },\n@@ -1296,6 +1296,7 @@\n \"label\": \"preact\",\n \"children\": [\n { \"label\": \"Kitchen Sink (All Features)\", \"to\": \"framework/preact/examples/kitchen-sink\" },\n+ { \"label\": \"Cell Selection\", \"to\": \"framework/preact/examples/cell-selection\" },\n { \"label\": \"Column Filters\", \"to\": \"framework/preact/examples/filters\" },\n { \"label\": \"Column Filters (Faceted)\", \"to\": \"framework/preact/examples/filters-faceted\" },\n { \"label\": \"Bucketed Faceted Filters\", \"to\": \"framework/preact/examples/filters-faceted-bucketed\" },\n@@ -1316,7 +1317,6 @@\n { \"label\": \"Pagination\", \"to\": \"framework/preact/examples/pagination\" },\n { \"label\": \"Row Pinning\", \"to\": \"framework/preact/examples/row-pinning\" },\n { \"label\": \"Row Selection\", \"to\": \"framework/preact/examples/row-selection\" },\n- { \"label\": \"Cell Selection\", \"to\": \"framework/preact/examples/cell-selection\" },\n { \"label\": \"Sorting\", \"to\": \"framework/preact/examples/sorting\" }\n ]\n },\ndiff --git a/docs/framework/alpine/guide/cell-selection.md b/docs/framework/alpine/guide/cell-selection.md\nindex f0dd6c8c48..4ec8ccf546 100644\n--- a/docs/framework/alpine/guide/cell-selection.md\n+++ b/docs/framework/alpine/guide/cell-selection.md\n@@ -279,7 +279,7 @@ onGridKeyDown: createMultiHotkeyHandler({\n }),\n \n // then, in the markup:\n-//

...

\n+//

...

\n ```\n \n Scope the hotkeys to the grid element rather than the document, or arrow keys and Escape will hijack inputs elsewhere on the page.\n@@ -291,9 +291,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -316,20 +322,25 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n - **Hiding a column** that a corner sits on makes the range inert. Nothing renders as selected, but the range stays in state and comes back when the column is shown again.\n - **Pagination** resolves against the pre-pagination order, so a range can span pages and lights up correctly on whichever page you are viewing.\n \n-Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n+Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision; an Alpine reactive effect can implement it:\n \n ```ts\n-// compare a layout key, then reset when it changes\n-const layoutKey = JSON.stringify([\n- table.atoms.columnOrder.get(),\n- table.atoms.columnPinning.get(),\n- table.atoms.columnVisibility.get(),\n-])\n-\n-if (layoutKey !== lastLayoutKey) {\n- lastLayoutKey = layoutKey\n- queueMicrotask(() => table.resetCellSelection(true))\n-}\n+let lastLayoutKey: string | undefined\n+\n+Alpine.effect(() => {\n+ const layoutKey = JSON.stringify([\n+ table.atoms.columnOrder.get(),\n+ table.atoms.columnPinning.get(),\n+ table.atoms.columnVisibility.get(),\n+ ])\n+\n+ if (lastLayoutKey === undefined) {\n+ lastLayoutKey = layoutKey\n+ } else if (layoutKey !== lastLayoutKey) {\n+ lastLayoutKey = layoutKey\n+ queueMicrotask(() => table.resetCellSelection(true))\n+ }\n+})\n ```\n \n ### Resetting Cell Selection\ndiff --git a/docs/framework/angular/guide/cell-selection.md b/docs/framework/angular/guide/cell-selection.md\nindex 415b461c68..b1d3a808cd 100644\n--- a/docs/framework/angular/guide/cell-selection.md\n+++ b/docs/framework/angular/guide/cell-selection.md\n@@ -292,9 +292,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -317,16 +323,24 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n - **Hiding a column** that a corner sits on makes the range inert. Nothing renders as selected, but the range stays in state and comes back when the column is shown again.\n - **Pagination** resolves against the pre-pagination order, so a range can span pages and lights up correctly on whichever page you are viewing.\n \n-Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n+Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision; an Angular effect can implement it:\n \n ```ts\n+let isFirstLayout = true\n+\n effect(() => {\n // read the atoms so this tracks only the layout slices\n this.table.atoms.columnOrder.get()\n this.table.atoms.columnPinning.get()\n this.table.atoms.columnVisibility.get()\n \n- untracked(() => this.table.resetCellSelection(true))\n+ untracked(() => {\n+ if (isFirstLayout) {\n+ isFirstLayout = false\n+ return\n+ }\n+ this.table.resetCellSelection(true)\n+ })\n })\n ```\n \ndiff --git a/docs/framework/ember/guide/cell-selection.md b/docs/framework/ember/guide/cell-selection.md\nindex 6e42134e34..e53c2d9802 100644\n--- a/docs/framework/ember/guide/cell-selection.md\n+++ b/docs/framework/ember/guide/cell-selection.md\n@@ -259,7 +259,7 @@ onGridKeyDown = createMultiHotkeyHandler({\n })\n \n // then, in the template:\n-//

...

\n+//

...

\n ```\n \n Scope the hotkeys to the grid element rather than the document, or arrow keys and Escape will hijack inputs elsewhere on the page.\n@@ -271,9 +271,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -296,19 +302,24 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n - **Hiding a column** that a corner sits on makes the range inert. Nothing renders as selected, but the range stays in state and comes back when the column is shown again.\n - **Pagination** resolves against the pre-pagination order, so a range can span pages and lights up correctly on whichever page you are viewing.\n \n-Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n+Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision. Invoke a callback like this from a grid element modifier or resource that tracks the layout atoms:\n \n ```ts\n-// compare a layout key, then reset when it changes\n-const layoutKey = JSON.stringify([\n- this.table.atoms.columnOrder.get(),\n- this.table.atoms.columnPinning.get(),\n- this.table.atoms.columnVisibility.get(),\n-])\n-\n-if (layoutKey !== this.lastLayoutKey) {\n- this.lastLayoutKey = layoutKey\n- queueMicrotask(() => this.table.resetCellSelection(true))\n+private lastLayoutKey: string | undefined\n+\n+onLayoutChange() {\n+ const layoutKey = JSON.stringify([\n+ this.table.atoms.columnOrder.get(),\n+ this.table.atoms.columnPinning.get(),\n+ this.table.atoms.columnVisibility.get(),\n+ ])\n+\n+ if (this.lastLayoutKey === undefined) {\n+ this.lastLayoutKey = layoutKey\n+ } else if (layoutKey !== this.lastLayoutKey) {\n+ this.lastLayoutKey = layoutKey\n+ queueMicrotask(() => this.table.resetCellSelection(true))\n+ }\n }\n ```\n \ndiff --git a/docs/framework/lit/guide/cell-selection.md b/docs/framework/lit/guide/cell-selection.md\nindex aac82e8f72..16ce895920 100644\n--- a/docs/framework/lit/guide/cell-selection.md\n+++ b/docs/framework/lit/guide/cell-selection.md\n@@ -259,7 +259,7 @@ const onGridKeyDown = createMultiHotkeyHandler({\n })\n \n // then, in the template:\n-// html`

...

`\n+// html`

...

`\n ```\n \n Scope the hotkeys to the grid element rather than the document, or arrow keys and Escape will hijack inputs elsewhere on the page.\n@@ -271,9 +271,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -296,19 +302,24 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n - **Hiding a column** that a corner sits on makes the range inert. Nothing renders as selected, but the range stays in state and comes back when the column is shown again.\n - **Pagination** resolves against the pre-pagination order, so a range can span pages and lights up correctly on whichever page you are viewing.\n \n-Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n+Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision; Lit's `updated` lifecycle can implement it:\n \n ```ts\n-// compare a layout key across renders, then reset when it changes\n-const layoutKey = JSON.stringify([\n- table.atoms.columnOrder.get(),\n- table.atoms.columnPinning.get(),\n- table.atoms.columnVisibility.get(),\n-])\n-\n-if (layoutKey !== this._lastLayoutKey) {\n- this._lastLayoutKey = layoutKey\n- queueMicrotask(() => table.resetCellSelection(true))\n+private _lastLayoutKey: string | undefined\n+\n+protected updated() {\n+ const layoutKey = JSON.stringify([\n+ this.table.atoms.columnOrder.get(),\n+ this.table.atoms.columnPinning.get(),\n+ this.table.atoms.columnVisibility.get(),\n+ ])\n+\n+ if (this._lastLayoutKey === undefined) {\n+ this._lastLayoutKey = layoutKey\n+ } else if (layoutKey !== this._lastLayoutKey) {\n+ this._lastLayoutKey = layoutKey\n+ queueMicrotask(() => this.table.resetCellSelection(true))\n+ }\n }\n ```\n \n@@ -339,11 +350,13 @@ The `subscribe` directive is available if you want an explicit fine-grained\n subscription for one part of a template:\n \n ```ts\n-subscribe(\n+import { subscribe } from '@tanstack/lit-table'\n+\n+html`${subscribe(\n table.atoms.cellSelection,\n (ranges) => ranges.length,\n (count) => html`${count} ranges`,\n-)\n+)}`\n ```\n \n Note that Lit renders into shadow DOM, so the selection classes must be defined\ndiff --git a/docs/framework/preact/guide/cell-selection.md b/docs/framework/preact/guide/cell-selection.md\nindex a1f1cdde5c..d283614889 100644\n--- a/docs/framework/preact/guide/cell-selection.md\n+++ b/docs/framework/preact/guide/cell-selection.md\n@@ -267,9 +267,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -295,7 +301,13 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n \n ```ts\n+const isFirstLayout = useRef(true)\n+\n useEffect(() => {\n+ if (isFirstLayout.current) {\n+ isFirstLayout.current = false\n+ return\n+ }\n table.resetCellSelection(true)\n }, [\n table.state.columnOrder,\n@@ -360,6 +372,31 @@ whose selected value is unchanged does not re-render:\n The selector needs to encode whether this row's cells fall inside a range,\n whether the rows immediately above and below do (that decides its top and bottom\n edges), and whether it owns the focused cell.\n+\n+```ts\n+function rowSelectionKey(ranges, bounds, rowIndex, rowId) {\n+ const active = ranges[ranges.length - 1]\n+ let key =\n+ ranges.length > 0 && active.anchorRowId === rowId\n+ ? `f${active.anchorColumnId}`\n+ : ''\n+\n+ for (const bound of bounds) {\n+ const self = rowIndex >= bound.minRowIndex && rowIndex <= bound.maxRowIndex\n+ const above =\n+ rowIndex - 1 >= bound.minRowIndex && rowIndex - 1 <= bound.maxRowIndex\n+ const below =\n+ rowIndex + 1 >= bound.minRowIndex && rowIndex + 1 <= bound.maxRowIndex\n+\n+ if (self || above || below) {\n+ key += `|${self ? 1 : 0}${above ? 1 : 0}${below ? 1 : 0}:${bound.minColumnIndex}-${bound.maxColumnIndex}`\n+ }\n+ }\n+\n+ return key\n+}\n+```\n+\n `table.getCellSelectionBounds()` is memoized, so it computes once per selection\n change no matter how many rows call it. On a thousand-row table this keeps a drag\n around 10ms per update instead of reconciling every cell.\ndiff --git a/docs/framework/react/guide/cell-selection.md b/docs/framework/react/guide/cell-selection.md\nindex 393b03cd7e..2ba28d2167 100644\n--- a/docs/framework/react/guide/cell-selection.md\n+++ b/docs/framework/react/guide/cell-selection.md\n@@ -268,9 +268,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -296,7 +302,13 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n \n ```tsx\n+const isFirstLayout = useRef(true)\n+\n useEffect(() => {\n+ if (isFirstLayout.current) {\n+ isFirstLayout.current = false\n+ return\n+ }\n table.resetCellSelection(true)\n }, [\n table.state.columnOrder,\ndiff --git a/docs/framework/solid/guide/cell-selection.md b/docs/framework/solid/guide/cell-selection.md\nindex f951edbe06..ba5dc2664d 100644\n--- a/docs/framework/solid/guide/cell-selection.md\n+++ b/docs/framework/solid/guide/cell-selection.md\n@@ -275,9 +275,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -300,7 +306,7 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n - **Hiding a column** that a corner sits on makes the range inert. Nothing renders as selected, but the range stays in state and comes back when the column is shown again.\n - **Pagination** resolves against the pre-pagination order, so a range can span pages and lights up correctly on whichever page you are viewing.\n \n-Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n+Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision; a deferred Solid effect can implement it:\n \n ```ts\n createEffect(\ndiff --git a/docs/framework/svelte/guide/cell-selection.md b/docs/framework/svelte/guide/cell-selection.md\nindex 445b9da6a1..949b9d8de6 100644\n--- a/docs/framework/svelte/guide/cell-selection.md\n+++ b/docs/framework/svelte/guide/cell-selection.md\n@@ -264,7 +264,7 @@ const gridKeys = createHotkeysAttachment([\n ])\n \n // then, in markup:\n-//

...

\n+//

...

\n ```\n \n Scope the hotkeys to the grid element rather than the document, or arrow keys and Escape will hijack inputs elsewhere on the page.\n@@ -276,9 +276,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -301,7 +307,7 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n - **Hiding a column** that a corner sits on makes the range inert. Nothing renders as selected, but the range stays in state and comes back when the column is shown again.\n - **Pagination** resolves against the pre-pagination order, so a range can span pages and lights up correctly on whichever page you are viewing.\n \n-Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n+Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision; a Svelte `$effect` can implement it:\n \n ```ts\n let isFirstColumnLayout = true\ndiff --git a/docs/framework/vue/guide/cell-selection.md b/docs/framework/vue/guide/cell-selection.md\nindex cc24f17795..f202ae4d33 100644\n--- a/docs/framework/vue/guide/cell-selection.md\n+++ b/docs/framework/vue/guide/cell-selection.md\n@@ -274,9 +274,15 @@ Scope the hotkeys to the grid element rather than the document, or arrow keys an\n ```ts\n function escapeTsvValue(value: unknown) {\n const text = value == null ? '' : String(value)\n+ const safeText =\n+ typeof value === 'string' && /^[\\t\\r ]*[=+@-]/.test(value)\n+ ? `'${text}`\n+ : text\n // spreadsheets expect a quoted field once it contains a delimiter, a newline,\n // or a quote, with inner quotes doubled\n- return /[\"\\t\\n\\r]/.test(text) ? `\"${text.replace(/\"/g, '\"\"')}\"` : text\n+ return /[\"\\t\\n\\r]/.test(safeText)\n+ ? `\"${safeText.replace(/\"/g, '\"\"')}\"`\n+ : safeText\n }\n \n function toTsv(ranges: Array>>) {\n@@ -299,7 +305,7 @@ Ranges store row and column ids, not positions, so they follow their corner cell\n - **Hiding a column** that a corner sits on makes the range inert. Nothing renders as selected, but the range stays in state and comes back when the column is shown again.\n - **Pagination** resolves against the pre-pagination order, so a range can span pages and lights up correctly on whichever page you are viewing.\n \n-Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision, and one `useEffect` away:\n+Because a reorder can widen a selection onto columns the user never picked, some applications prefer to clear the selection whenever the column layout changes. That is a userland decision; a Vue `watch` can implement it:\n \n ```ts\n watch(\ndiff --git a/docs/reference/index/interfaces/Table_CellSelection.md b/docs/reference/index/interfaces/Table_CellSelection.md\nindex 5e4b5cff47..aad0a48f68 100644\n--- a/docs/reference/index/interfaces/Table_CellSelection.md\n+++ b/docs/reference/index/interfaces/Table_CellSelection.md\n@@ -179,8 +179,8 @@ Defined in: [features/cell-selection/cellSelectionFeature.types.ts:252](https://\n \n Returns the number of selected cells.\n \n-Computed as rectangle arithmetic. Falls back to enumerating cells when\n-`enableCellSelection` is a per-cell predicate.\n+Computed as rectangle arithmetic for one range. Falls back to enumerating\n+cells for overlapping ranges or a per-cell `enableCellSelection` predicate.\n \n #### Returns\n \n@@ -196,7 +196,7 @@ getSelectedCellIds: () => string[];\n \n Defined in: [features/cell-selection/cellSelectionFeature.types.ts:259](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.types.ts#L259)\n \n-Returns the ids of all selected cells, in row-major order per range.\n+Returns the unique ids of all selected cells, in row-major order.\n \n This expands the selection, so it costs one pass over the selected area.\n It is memoized and never runs unless called.\ndiff --git a/docs/reference/static-functions/functions/cell_getIsSelected.md b/docs/reference/static-functions/functions/cell_getIsSelected.md\nindex 645cbc9ce2..204ee18839 100644\n--- a/docs/reference/static-functions/functions/cell_getIsSelected.md\n+++ b/docs/reference/static-functions/functions/cell_getIsSelected.md\n@@ -11,6 +11,12 @@ function cell_getIsSelected(cell): boolean;\n \n Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:396](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L396)\n \n+Checks whether this cell falls inside any selected range.\n+\n+Deliberately not memoized. Registering this through `assignPrototypeAPIs`\n+with `memoDeps` would allocate a memo closure and dependency array per cell,\n+which costs more than the handful of integer comparisons it would save.\n+\n ## Type Parameters\n \n ### TFeatures\n@@ -34,3 +40,9 @@ Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:396](https://\n ## Returns\n \n `boolean`\n+\n+## Example\n+\n+```ts\n+const isSelected = cell_getIsSelected(cell)\n+```\ndiff --git a/docs/reference/static-functions/functions/cell_getSelectionExtendHandler.md b/docs/reference/static-functions/functions/cell_getSelectionExtendHandler.md\nindex 300a82b078..e7b75ec6e8 100644\n--- a/docs/reference/static-functions/functions/cell_getSelectionExtendHandler.md\n+++ b/docs/reference/static-functions/functions/cell_getSelectionExtendHandler.md\n@@ -9,7 +9,7 @@ title: cell_getSelectionExtendHandler\n function cell_getSelectionExtendHandler(cell): (_e) => void;\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:1098](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L1098)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:1143](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L1143)\n \n Creates a handler that extends the active range to this cell during a drag.\n \ndiff --git a/docs/reference/static-functions/functions/cell_getSelectionStartHandler.md b/docs/reference/static-functions/functions/cell_getSelectionStartHandler.md\nindex bcda7b78e5..75edb2b12a 100644\n--- a/docs/reference/static-functions/functions/cell_getSelectionStartHandler.md\n+++ b/docs/reference/static-functions/functions/cell_getSelectionStartHandler.md\n@@ -9,7 +9,7 @@ title: cell_getSelectionStartHandler\n function cell_getSelectionStartHandler(cell, _contextDocument?): (e) => void;\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:1023](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L1023)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:1068](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L1068)\n \n Creates a handler that begins a selection at this cell.\n \ndiff --git a/docs/reference/static-functions/functions/table_extendCellSelection.md b/docs/reference/static-functions/functions/table_extendCellSelection.md\nindex 8f50f508f8..fde851c4ac 100644\n--- a/docs/reference/static-functions/functions/table_extendCellSelection.md\n+++ b/docs/reference/static-functions/functions/table_extendCellSelection.md\n@@ -9,7 +9,7 @@ title: table_extendCellSelection\n function table_extendCellSelection(table, direction): void;\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:725](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L725)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:761](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L761)\n \n Extends the active range one step in a direction, keeping its anchor fixed.\n \ndiff --git a/docs/reference/static-functions/functions/table_getCellSelectionColumnIds.md b/docs/reference/static-functions/functions/table_getCellSelectionColumnIds.md\nindex 618478d24d..054ac3592d 100644\n--- a/docs/reference/static-functions/functions/table_getCellSelectionColumnIds.md\n+++ b/docs/reference/static-functions/functions/table_getCellSelectionColumnIds.md\n@@ -9,7 +9,7 @@ title: table_getCellSelectionColumnIds\n function table_getCellSelectionColumnIds(table): string[];\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:973](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L973)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:1018](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L1018)\n \n Returns the ids of all columns intersected by the selection.\n \ndiff --git a/docs/reference/static-functions/functions/table_getCellSelectionRowIds.md b/docs/reference/static-functions/functions/table_getCellSelectionRowIds.md\nindex c4e056dc2e..41f6576d68 100644\n--- a/docs/reference/static-functions/functions/table_getCellSelectionRowIds.md\n+++ b/docs/reference/static-functions/functions/table_getCellSelectionRowIds.md\n@@ -9,7 +9,7 @@ title: table_getCellSelectionRowIds\n function table_getCellSelectionRowIds(table): string[];\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:936](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L936)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:981](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L981)\n \n Returns the ids of all rows intersected by the selection.\n \ndiff --git a/docs/reference/static-functions/functions/table_getSelectedCellCount.md b/docs/reference/static-functions/functions/table_getSelectedCellCount.md\nindex 21cac9bee8..55b2e31856 100644\n--- a/docs/reference/static-functions/functions/table_getSelectedCellCount.md\n+++ b/docs/reference/static-functions/functions/table_getSelectedCellCount.md\n@@ -9,13 +9,13 @@ title: table_getSelectedCellCount\n function table_getSelectedCellCount(table): number;\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:886](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L886)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:932](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L932)\n \n Returns the number of selected cells.\n \n-Uses rectangle arithmetic, which needs no expansion. When\n-`enableCellSelection` is a per-cell predicate the cells have to be visited\n-individually, so that path falls back to enumeration.\n+Uses rectangle arithmetic for a single range, which needs no expansion.\n+Multiple ranges are enumerated so overlapping cells are counted once. A\n+per-cell `enableCellSelection` predicate also requires enumeration.\n \n ## Type Parameters\n \ndiff --git a/docs/reference/static-functions/functions/table_getSelectedCellIds.md b/docs/reference/static-functions/functions/table_getSelectedCellIds.md\nindex caf61c0f2b..b7562be24f 100644\n--- a/docs/reference/static-functions/functions/table_getSelectedCellIds.md\n+++ b/docs/reference/static-functions/functions/table_getSelectedCellIds.md\n@@ -9,9 +9,12 @@ title: table_getSelectedCellIds\n function table_getSelectedCellIds(table): string[];\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:838](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L838)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:877](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L877)\n \n-Returns the ids of all selected cells, in row-major order per range.\n+Returns the ids of all selected cells, in row-major order.\n+\n+Cells covered by overlapping ranges are returned once, at their first\n+occurrence.\n \n ## Type Parameters\n \ndiff --git a/docs/reference/static-functions/functions/table_getSelectedCellRangesData.md b/docs/reference/static-functions/functions/table_getSelectedCellRangesData.md\nindex d24c823750..60d667abb6 100644\n--- a/docs/reference/static-functions/functions/table_getSelectedCellRangesData.md\n+++ b/docs/reference/static-functions/functions/table_getSelectedCellRangesData.md\n@@ -9,7 +9,7 @@ title: table_getSelectedCellRangesData\n function table_getSelectedCellRangesData(table): unknown[][][];\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:859](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L859)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:905](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L905)\n \n Returns each selected range's values as a row-major grid.\n \ndiff --git a/docs/reference/static-functions/functions/table_moveCellSelection.md b/docs/reference/static-functions/functions/table_moveCellSelection.md\nindex ae9b28ae39..98e9ef0651 100644\n--- a/docs/reference/static-functions/functions/table_moveCellSelection.md\n+++ b/docs/reference/static-functions/functions/table_moveCellSelection.md\n@@ -9,7 +9,7 @@ title: table_moveCellSelection\n function table_moveCellSelection(table, direction): void;\n ```\n \n-Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:688](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L688)\n+Defined in: [features/cell-selection/cellSelectionFeature.utils.ts:724](https://github.com/TanStack/table/blob/main/packages/table-core/src/features/cell-selection/cellSelectionFeature.utils.ts#L724)\n \n Moves the selection one step in a direction, collapsing it to a single cell.\n \ndiff --git a/examples/alpine/cell-selection/index.html b/examples/alpine/cell-selection/index.html\nindex b5e5a1e022..2cd4ad0e2d 100644\n--- a/examples/alpine/cell-selection/index.html\n+++ b/examples/alpine/cell-selection/index.html\n@@ -93,7 +93,7 @@\n -->\n

\n-

\n+

\n \n \n \n