twico-ui 1.27.0 → 1.29.0

package/llms.txt

@@ -1562,7 +1562,8 @@ Props:
 - `loading` — `boolean` · default `false` — Replaces the grid body with skeleton rows while data is being fetched; off by default.
 - `rowKey` — `(row,index)=>key` · default `(r,i)=>r.id??i` — Returns a stable unique key per row, defaulting to the row's id or its index, to keep selection and renders consistent.
 - `checkboxSelection` — `boolean` · default `false` — Adds a leading checkbox column for selecting rows, enabling batch actions; off by default.
-- `batchActions` — `DatatableBatchAction array` · default `[]` — Defines actions shown in the selection toolbar that operate on the currently selected rows; empty by default.
+- `batchActions` — `DatatableBatchAction array` · default `[]` — Actions in the selection toolbar that operate on the selected rows; each action's disabled/hidden can be a predicate (keys, rows) => boolean evaluated against the current selection.
+- `onRowSelectionChange` — `(keys,rows)=>void` · default `-` — Fires when the checkbox row selection changes, with the selected keys and rows — the row-mode analogue of onCellSelectionChange, for driving a batch action's disabled state.
 - `density` — `compact|standard|comfortable` · default `comfortable` — Sets the row height preset (compact, standard, or comfortable) to trade vertical space for readability, defaulting to comfortable.
 - `pageSize` — `number` · default `10` — Rows per page (0 disables pagination). Uncontrolled by default (changing it re-applies + resets to page 0); controlled when onPageSizeChange is set.
 - `page` — `number` — Controlled current page (0-based); when set, the table renders this page and reports changes via onPageChange.
@@ -1590,6 +1591,8 @@ Props:
 - `showPageJumper` — `boolean` · default `true` — Shows a go-to-page input in the pagination footer for jumping directly to a page number; enabled by default.
 - `selectionMode` — `none|row|cell` · default `none` — Sets click-to-select granularity (none, row, or cell), controlling what gets highlighted on click, defaulting to none.
 - `onRowClick` — `(row,key)=>void` · default `-` — Fires with the clicked row and its key, useful for navigation or opening a detail view.
+- `activeRowId` — `string | number | null` · default `-` — Controlled highlighted row key for selectionMode="row": the grid highlights this row (not internal state) and reports clicks via onRowClick so you update it; null clears it. Lets an external selection drive the highlight.
+- `scrollActiveRowIntoView` — `boolean` · default `true` — Scroll the controlled active row into view when activeRowId changes.
 - `onCellClick` — `(value,row,field)=>void` · default `-` — Fires with the clicked cell's value, its row, and the field name when a cell is clicked.
 - `onActiveCellChange` — `(cell|null)=>void` · default `-` — Fires when the active cell changes via keyboard or click, receiving the new cell descriptor or null.
 - `onCellSelectionChange` — `(cells)=>void` · default `-` — Fires when the rectangular cell selection changes in cell mode (Shift+Click / Shift+Arrow), with every selected cell {key, field} in row-major order.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twico-ui",
-  "version": "1.27.0",
+  "version": "1.29.0",
   "description": "Twico UI — a free, modern, themeable React + Tailwind-friendly component library. 61 components with dark mode, motion, and accessibility built in.",
   "license": "MIT",
   "author": "Twico UI",