twico-ui 1.45.1 → 1.46.0

package/llms.txt

@@ -1561,6 +1561,7 @@ Props:
 - `label` — `React.ReactNode` — Optional heading rendered above the grid and associated with it for accessibility.
 - `checkboxSelection` — `boolean` · default `false` — Shows a selection checkbox on each card and a batch toolbar once anything is picked — the same prop as Datatable.
 - `batchActions` — `CardGridBatchAction<Row>[]` · default `[]` — Actions for the selection toolbar; disabled, hidden and disabledReason may each be predicates over the current selection.
+- `selectionSummary` — `React.ReactNode | ((keys: Array<string | number>, rows: Row[]) => React.ReactNode)` — Extra node in the SELECTION toolbar, beside the "N selected" count and before the batch actions — for the number the count does not carry. A batch capped by total size refuses on gigabytes, not on items, so "12 selected" is not the number the user needs and "12 selected · 2.4 GB" is. Prefer the function form: it receives the same (keys, rows) the batch actions get, so you supply one pure function and keep no selection state of your own. Complements disabledReason, which explains the refusal once a cap is exceeded — this is the running total before that point.
 - `onRowSelectionChange` — `(keys: Array<string | number>, rows: Row[]) => void` — Fires when the selection changes, receiving the complete keys and the row objects that could be resolved.
 - `selectionPlacement` — `"top-start" | "top-end" | "bottom-start" | "bottom-end" | "none"` · default `"top-start"` — Which corner the grid draws its checkbox in; none suppresses the overlay so you can place it yourself.
 - `selectionLabel` — `(row: Row, index: number) => string` — Per-card aria-label for the checkbox — worth setting, since a card's content is not announced with the control.
@@ -1639,6 +1640,7 @@ Props:
 - `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 `[]` — 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.
+- `selectionSummary` — `React.ReactNode | ((keys: Array<string | number>, rows: T[]) => React.ReactNode)` — Extra node in the SELECTION toolbar, beside the "N selected" count and before the batch actions — for the number the count does not carry. A batch capped by total size refuses on gigabytes, not on items, so "12 selected" is not the number the user needs and "12 selected · 2.4 GB" is. Prefer the function form: it receives the same (keys, rows) the batch actions get, so you supply one pure function and keep no selection state of your own. Complements disabledReason, which explains the refusal once a cap is exceeded — this is the running total before that point.
 - `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.
@@ -1708,7 +1710,7 @@ Props:
 - `filterLogic` — `"and" | "or"` — Controlled And/Or connective between filter conditions — a single set-wide operator (MUI DataGrid-style); pair with onFilterLogicChange. Omit for uncontrolled (see defaultFilterLogic).
 - `defaultFilterLogic` — `"and" | "or"` · default `"and"` — Initial And/Or connective for the filter conditions when filterLogic is left uncontrolled.
 - `onFilterLogicChange` — `(logic: "and" | "or") => void` — Fires with the new connective when the user changes the per-row And/Or connector in the Filters panel.
-- `toolbarActions` — `React.ReactNode` — Custom node rendered in a leading toolbar slot, before the built-in Columns/Filters cluster — for host controls like an "Add row" button or bulk actions. Mirrors CardGrid's toolbar prop, so no internal-class or absolute-position hacks are needed.
+- `toolbarActions` — `React.ReactNode` — Custom node rendered in the toolbar after the built-in cluster (Columns, Filters, Density, Aggregation, Pivot, Export) and before the search box — for host controls like an "Add row" button or bulk actions. Host buttons therefore read as an extension of the built-in ones rather than displacing them, and the search keeps the right-hand edge. Mirrors CardGrid's toolbar prop, so no internal-class or absolute-position hacks are needed.
 - `resizableFilters` — `boolean` · default `true` — Let the user drag-resize the Filters popover and its column/operator/value fields, layered over the auto-fit (a dragged width overrides the measured one; reset returns to it). Widths + panel size persist via stateKey and are keyboard-accessible. Set false to hide the handles/grip (fields still auto-fit).
 - `filterFieldMaxWidth` — `number` — Raise the drag cap for the filter panel's column/operator fields, in px (defaults: column 360, operator 260). Only applies when resizableFilters is on.
 - `resizablePopovers` — `boolean` · default `true` — Extend the resize grip + keyboard resize to the Columns, Aggregation, Pivot, and Batch-edit panels (not just Filters), so a wide grid's Columns list can be enlarged. Sizes persist per popover via stateKey. Independent of resizableFilters; defaults true — set false to opt a grid out.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twico-ui",
-  "version": "1.45.1",
+  "version": "1.46.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",