Changelog
What's new in each release of the blocks and the @querycn packages, and what to do when you update.
Newest first. A release can change the npm packages, the registry blocks, or both:
- Packages (
@querycn/*) update withnpm install @querycn/table-react@latest …. - Blocks (
data-table,filter-builder) are files in your project, so they only change when you add them again. See Updating.
The full list of package changes is in each package's CHANGELOG.md on GitHub.
October 10, 2026
Changes to the blocks only: they now need @querycn/table-react 0.4.0.
New
- Bulk edit. While rows are selected, the floating bar shows Bulk edit for tables with editable columns. Its dialog picks columns and a value for each, with the column's own editor, and saves them in every selected row: one
onBulkEditcall, oronCellEditper changed cell. See Bulk edit. DataTableToolbarandDataTableSelectionBartakecellEditors, for your own editors in the dialog.
Changed
- The selection bar shows for editable tables even without
selectionActions, to offer Bulk edit.
Updating
- Update the package:
npm install @querycn/table-react@latest. - Add the
data-tableblock again with--overwrite:npx shadcn@latest add @tablecn/data-table --overwrite. It brings four new files,data-table-bulk-edit-dialog.tsx,data-table-bulk-edit-field.tsx,use-bulk-edit.tsandbulk-edit-fields.ts, and shadcn'sdialog. Commit your changes first. - If you pass your own editors to
DataTable, pass them toDataTableToolbartoo.
October 9, 2026
| Package | Version |
|---|---|
@querycn/table-react | 0.4.0 |
New
- Bulk edit in
@querycn/table-react.useDataTable's newonBulkEditsaves the same values in every selected row in one call: it gets{ rowIds, rows, changes, options }, wherechangesholds the new value of each column andoptionsthe picked option of eachselectcolumn. If it throws,applyBulkEditrejects with the error. WithoutonBulkEdit, a bulk edit callsonCellEditfor each changed cell.getBulkEditColumns(table, rows)lists the columns a bulk edit can change, those withmeta.editthatcanEditCellallows in every row, andapplyBulkEdit(table, rows, changes, options)saves the edit. Thedata-tableblock doesn't have a bulk edit dialog yet; these are for building your own. - Cards and a stacked toolbar on small screens. When the table's container is narrower than
36rem(576px), each row shows as a card: the selection checkbox, the first column as the title, the columns pinned to the end beside it, and the other visible columns below with their labels. Selection, the floating bar,onRowClickandrowClassNamework on cards; editing stays in the table. A virtualized table keeps the table layout. The toolbar stacks too: the search on its own line, the filter beside the buttons, then the chips, and Columns shows only its icon. Both follow their container's width, not the screen's, with Tailwind container queries you can change. See Responsive.
Changed
- The selection bar floats over the table. It's a pill at the bottom of the table, like a toast: × to clear the selection, the count, then your
selectionActions. It stays in view while the table scrolls past and never covers the pagination. Its colors are the theme's swapped, and it's a toolbar you can move through with the arrow keys.selectionActionsis unchanged; give its buttonsvariant="ghost". Clear selection is now an × button with that name. See The floating bar.
Updating
- Update the package for bulk edit:
npm install @querycn/table-react@latest. If you pass a complete message object instead of usingmergeTableMessages, add the newbulkEditgroup. TypeScript points out what's missing. - Add the
data-tableblock again with--overwrite:npx shadcn@latest add @tablecn/data-table --overwrite. It brings three new files,use-floating-selection-bar.ts,toolbar-arrow-keys.tsanddata-table-cards.tsx. Commit your changes first. - If your tests render the table in jsdom, query inside the table:
within(screen.getByRole("table")). The cards repeat each value, and jsdom doesn't run the container queries that hide them.
September 29, 2026
Changes to the blocks only: no package release.
Fixed
cncomes from thecnpackage, like shadcn/ui's current styles, so the blocks build in projects withoutlib/utils.ts. The blocks listcnas a dependency. (#7)- The table fills its border. When the columns add up to less than the container, a filler cell takes the rest, so rows and their hover and selection colors reach the border. Columns pinned to the end stay against the end edge. (#8)
- One line under the header, instead of two stacked 1px lines. (#9)
- No
react-hooks/refserrors indata-table-editable-cell.tsxwitheslint-config-next16. (#6)
Updating
Add the blocks again with --overwrite: npx shadcn@latest add @tablecn/data-table @tablecn/filter-builder --overwrite. Commit your changes first.
September 28, 2026
| Package | Version |
|---|---|
@querycn/table-react | 0.3.0 |
@querycn/filter-core, @querycn/filter-react, @querycn/filter-next | 0.3.0 |
New
@tablecnis in the shadcn registry directory.npx shadcn@latest add @tablecn/data-tableworks right away, without adding the registry tocomponents.jsonfirst.- Inline editing. Users edit a cell where it is: Enter, F2 or a double click opens its editor, Enter saves. Turn it on with
meta.editon a column andonCellEditinuseDataTable, which can save to your API and throw to show an error under the cell. Editors for text, numbers, selects and yes/no, a select can search your API withloadOptions, and you can add your own. See Inline editing. - A
timefield type for a time of day with no date, like09:30, with is at, is after, is between and the other time operators. See Fields. - Time and date-time pickers. The filter picks times and date-times from scrolling hour and minute columns, with Now and OK. Both pickers are also standalone components you can copy: Time picker and Date time picker.
- A Full example page: one orders table with every feature on, and all of its code.
- A Right-to-left page, with a live Arabic-direction table and the setup for Radix UI, Base UI and React Aria.
Fixed
- While dragging a column's edge, the resize cursor stays on, even when the pointer leaves the header.
- On right-to-left pages, headers and cells align to the right, the selection checkbox keeps its space from the table's edge, the resize line is centered on the edge, and the filter's range arrow points from the start to the end.
- Popovers (the filter panel, pickers, the Columns menu, the API select editor) and the filter's calendars follow the direction of your primitive library's provider, even when only part of the page is right-to-left. The Radix UI and Base UI blocks now list
radix-ui/@base-ui/reactas dependencies for it. - The blocks ask for the package versions they use.
data-tableasked for@querycn/table-react@^0.1.0, so a new install could get an older version than the block needs.
Updating
- Update the packages:
npm install @querycn/table-react@latest @querycn/filter-react@latest(and@querycn/filter-next@lateston Next.js). - Add the blocks again to get inline editing and the pickers:
npx shadcn@latest add @tablecn/data-table @tablecn/filter-builder --overwrite. Commit your changes first. - If you pass complete message objects instead of using
mergeTableMessages/mergeMessages, add the new texts: the table'seditinggroup, and the filter'splaceholders.time,placeholders.hour,placeholders.minute,actions.nowandactions.ok. TypeScript points out what's missing.
September 26, 2026
| Package | Version |
|---|---|
@querycn/table-react | 0.2.0 |
New
- Turn a feature off for the whole table:
enableSorting,enableColumnResizingandenableColumnOrderinginuseDataTable. PassenableSortingtouseTableQuerytoo, so your backend never gets a sort the table ignores. See Columns.
Changed
- The selection bar under the toolbar only shows when you pass
selectionActions. Without actions, the pagination already counts the selected rows. See Row selection.
Fixed
- The selection column has no ⋯ menu, which used to cover its select-all checkbox.
Updating
Update @querycn/table-react, and add @tablecn/data-table again with --overwrite.
September 25, 2026: first release
| Package | Version |
|---|---|
@querycn/filter-core, @querycn/filter-react, @querycn/filter-next | 0.2.0 |
@querycn/table-react | 0.1.0 |
- The
data-tableblock: search, sorting by one or several columns, pages, row selection, loading, empty and error states, and virtualization. Users move, resize, pin, hide and color columns, and their layout is saved in the browser. - The
filter-builderblock: conditions like Status is Paid and Amount is between 10 and 50, with AND / OR, chips, and options loaded from your API. - Everything in the URL:
?q=nguyen&status__eq=paid&sort=-amount&page=2, through adapters for Next.js, react-router and the browser. - Client or server data, with request builders for JSON:API-style APIs, django-filter and PostgREST.
- Radix UI, Base UI and React Aria versions of both blocks, and English and Vietnamese texts.