@iyulab/flex-table 0.56.1 → 0.57.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.57.0] - 2026-10-07
+
+### Changed (breaking)
+
+- **`getSelectedRows()` returns the selected rows** (`DataRow[]` — the rows `data` holds, in `data` order), the same
+  shape as `u-rich-table`'s `getSelectedRows()`. It returned `{ selectedIds, selectedIndices, selectedRows }`, so code
+  written for one table read `undefined` from the other (`getSelectedRows().length`). Every selected id, on every page,
+  is `selectedRowIds`; positions in `data` come with `selection-change` (`selectedIndices`), whose detail is unchanged.
+
+**Migrating**: `getSelectedRows().selectedRows` → `getSelectedRows()` · `.selectedIds` → `[...selectedRowIds]` ·
+`.selectedIndices` → the `selection-change` detail, or `getSelectedRows().map((r) => table.data.indexOf(r))`.
+
 ## [0.56.1] - 2026-10-07
 
 ### Fixed

package/README.md

@@ -258,7 +258,7 @@ Every row keeps its own value. Sorting, filtering, copying, CSV/XLSX export and
 | `deselectAll()` | `void` | Deselect every row, on every page |
 | `selectWhere(predicate)` | `void` | Add the rows in view for which `predicate(row, dataIndex)` is true |
 | `setSelection(ids)` | `void` | Replace the selection with these row ids. The same set again does nothing and fires nothing |
-| `getSelectedRows()` | `{ selectedIds, selectedIndices, selectedRows }` | `selectedIds`: every selected row (all pages). `selectedRows` / `selectedIndices`: the selected rows `data` holds, and their positions in it |
+| `getSelectedRows()` | `DataRow[]` | The selected rows `data` holds, in `data` order — the same shape as `u-rich-table`'s. Every selected id (all pages) is `selectedRowIds`; positions come with `selection-change` (`selectedIndices`) |
 | `getRowId(row)` | `string` | The id selection keeps for a row |
 | `selectedRowIds` (getter) | `ReadonlySet<string>` | Ids of the selected rows, all pages (a copy) |
 
@@ -268,7 +268,7 @@ Row selection is kept by **row id**, not by position, so a checkmark stays on it
 table.rowKey = 'orderNo';                       // or: table.rowKey = (row) => `${row.site}/${row.no}`
 ```
 
-A keyed row stays selected when `data` is replaced, so in a server-paged grid the selection spans pages (`selectedIds` names them all; `selectedRows` holds the ones on this page). A row without a key is named by the row object itself (a session-local id `#n`): it follows the row while the same object is in `data` and leaves the selection when it is gone. Set `clear-selection-on-data-change` when every new `data` should start a new selection (a new search):
+A keyed row stays selected when `data` is replaced, so in a server-paged grid the selection spans pages (`selectedRowIds` names them all; `getSelectedRows()` holds the ones on this page). A row without a key is named by the row object itself (a session-local id `#n`): it follows the row while the same object is in `data` and leaves the selection when it is gone. Set `clear-selection-on-data-change` when every new `data` should start a new selection (a new search):
 
 ```html
 <flex-table selectable clear-selection-on-data-change></flex-table>

package/dist/{flex-table-DKBcfNA4.js → flex-table-B1W8VEBa.js}

@@ -1844,6 +1844,9 @@ var K = {
 		return this._filteredIndices.length;
 	}
 	getSelectedRows() {
+		return this._selectionSnapshot().selectedRows;
+	}
+	_selectionSnapshot() {
 		let e = [];
 		if (this._rowSelection.selectedCount > 0) for (let t = 0; t < this.data.length; t++) this._rowSelection.isSelected(this.getRowId(this.data[t])) && e.push(t);
 		return {
@@ -1880,7 +1883,7 @@ var K = {
 		}
 	}
 	_dispatchRowSelectionEvent() {
-		this._emit("selection-change", this.getSelectedRows());
+		this._emit("selection-change", this._selectionSnapshot());
 	}
 	_visibleRowIds() {
 		let e = this._visibleIdsCache;
@@ -2081,7 +2084,7 @@ var K = {
 		}), this._dispatchUndoStateEvent(), n;
 	}
 	deleteRows(e) {
-		let t = e ?? (this.selectable ? this.getSelectedRows().selectedIndices : this._getSelectedDataRows());
+		let t = e ?? (this.selectable ? this._selectionSnapshot().selectedIndices : this._getSelectedDataRows());
 		if (t.length === 0) return;
 		let n = [...t].sort((e, t) => t - e), r = [];
 		for (let e of n) e >= 0 && e < this.data.length && (r.push({

package/dist/flex-table.d.ts

@@ -192,15 +192,13 @@ export declare class FlexTable extends LitElement {
     /** Number of rows after filtering (before pagination). */
     get filteredRowCount(): number;
     /**
-     * The row selection. `selectedIds` is every selected row — on every page, including rows not in
-     * `data` now. `selectedRows` and `selectedIndices` are the selected rows that `data` holds (in
-     * `data` order, filtered-out rows included) and their positions in it.
-     */
-    getSelectedRows(): {
-        selectedIds: string[];
-        selectedIndices: number[];
-        selectedRows: DataRow[];
-    };
+     * The selected rows that `data` holds, in `data` order (filtered-out rows included) — the same shape
+     * as `u-rich-table`'s. Every selected id, on every page, is `selectedRowIds`; positions in `data` come
+     * with `selection-change` (`selectedIndices`).
+     */
+    getSelectedRows(): DataRow[];
+    /** The selection as `selection-change` reports it. */
+    private _selectionSnapshot;
     /** The id row selection keeps for `row` — its `rowKey` value as a string, or `#n` for a row without one. */
     getRowId(row: DataRow): string;
     /** Ids of the selected rows — every page, including rows not in `data` now. A copy. */

package/dist/flex-table.js

@@ -1,3 +1,3 @@
-import { a as e, i as t, n, o as r, r as i, t as a } from "./flex-table-DKBcfNA4.js";
+import { a as e, i as t, n, o as r, r as i, t as a } from "./flex-table-B1W8VEBa.js";
 import { t as o } from "./locale-Cfm-vJji.js";
 export { a as FlexTable, e as RowSelectionState, t as UndoStack, n as effectiveAlign, i as exportData, o as flexTableLocale, r as renderCell };

package/dist/react.js

@@ -1,4 +1,4 @@
-import { t as e } from "./flex-table-DKBcfNA4.js";
+import { t as e } from "./flex-table-B1W8VEBa.js";
 import { i as t } from "./query-Dw4iO0ir.js";
 import { t as n } from "./source--q5s2Oti.js";
 import { t as r } from "./view-DiLr-TdY.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/flex-table",
-  "version": "0.56.1",
+  "version": "0.57.0",
   "description": "A minimalist, input-centric data grid web component",
   "type": "module",
   "main": "./dist/flex-table.js",

package/skills/iyulab-flex-table/references/api.md

@@ -119,7 +119,7 @@ Enter/Escape and blur-to-commit behavior.
 | `selectAll()` / `deselectAll()` | `selectAll`: the rows in view (multi mode only) · `deselectAll`: every page |
 | `selectWhere(predicate)` | `(row, dataIndex) => boolean` over the visible rows |
 | `setSelection(ids)` | Replace with these row ids; the same set again fires nothing |
-| `getSelectedRows()` | `{ selectedIds, selectedIndices, selectedRows }` — ids: all pages · rows: the ones `data` holds |
+| `getSelectedRows()` | `DataRow[]` — the selected rows `data` holds (as `u-rich-table`) · ids of every page: `selectedRowIds` |
 | `getRowId(row)` · `selectedRowIds` | A row's id · the selected ids (all pages) |
 
 ### Filtering, undo, comments, import/export