Changelog
Latest updates, improvements, and announcements.
November 2026 - Data Table Config
November 13, 2026
Data Table now describes each table once with createDataTableConfig. The server reads the URL with config.parse, and useDataTable takes the same config, so the two can't drift. This release has breaking changes for server mode, column configs, and table defaults.
Breaking changes
-
One config for the server and the hook.
getDataTableSearchParamsandgetDataTableQueryare removed. Create the config once and parse the search params with it.import { getDataTableSearchParams } from "@/lib/data-table-parsers"; import { createDataTableConfig } from "@/lib/data-table-config"; export const searchParamsCache = createSearchParamsCache( getDataTableSearchParams({ columnConfigs, defaultSorting }), ); export const tasksTableConfig = createDataTableConfig({ columns: columnConfigs, defaultSorting, }); const search = searchParamsCache.parse(searchParams); const query = getDataTableQuery(search, columnConfigs); const query = tasksTableConfig.parse(searchParams);Type the query with
InferDataTableQuery<typeof tasksTableConfig>instead ofDataTableColumnConfigsQuery<typeof columnConfigs>. -
Columns read the config.
getColumnOptionsis removed. Pass the config touseDataTableand it sets each column's filter and sorting. Columns the config doesn't list can't be filtered or sorted.{ accessorKey: "title", meta: { label: "Title" }, ...getColumnOptions(columnConfigs.title), } useDataTable({ config: tasksTableConfig, data, columns, pageCount, }); -
Defaults move to the config. Sorting, page size, page size options, the join operator, and the global filter switch are set on the config.
useDataTablealso takes inline options, likeconfig: { defaultSorting }.useDataTable({ data, columns, initialState: { sorting: [{ id: "createdAt", desc: true }], pagination: { pageIndex: 0, pageSize: 20 }, }, enableGlobalFilter: false, config: { defaultSorting: [{ id: "createdAt", desc: true }], defaultPageSize: 20, enableGlobalFilter: false, }, }); <DataTablePagination table={table} pageSizeOptions={[10, 25, 50]} /> createDataTableConfig({ columns, pageSizeOptions: [10, 25, 50] }); -
idreplacesqueryKeys. Give the config anidto render several tables on one page. It prefixes every URL key, like?tasks.page=2.useDataTable({ queryKeys: { page: "tasksPage", perPage: "tasksPerPage" }, config: createDataTableConfig({ id: "tasks", columns }), }); -
Column config and variant names.
Before After isSortable: falseenableSorting: false"multi-select""select""select"(one option)"select"withmultiple: falsein the column meta"number"withfilter: "range""number", withminandmaxin the column meta for the slider"date"withfilter: "range""date" -
Removed hook props.
throttleMsandautoResetPageIndexare removed.debounceMsonly applies withshallow: falsein server mode, andclearOnDefaultnow defaults totrue. -
Removed helpers.
isRelativeToTodayand theDataTableQueryKeystype are removed.
Data Table
- Global filter in the URL. The global filter is stored as
?search=and reaches the server asquery.globalFilter. PassglobalFilterPlaceholderto either toolbar to show a search input. - Sticky header. Set
stickyHeaderonDataTableto scroll the rows inside the table and keep the header in view. - Escape clears the selection. Pressing Escape inside the table clears the row selection. Call
event.preventDefault()inonEscapeKeyDownto keep it. - Header sort. Picking Asc or Desc in a column header makes it the first sort and keeps the others as tiebreakers, unless multi-sort is off.
- Column ids. Columns defined by
accessorKeyalone now sort and filter through the URL, andDataTableColumnHeaderreads itslabelfrommeta.labelwhen you leave it out. - Pagination. A page size that isn't one of the options still shows in the select, and in client mode, changing rows no longer jumps back to page 1.
- Narrow widths and long labels. Toolbars, filter menus, chips, and headers wrap or truncate instead of overflowing, and labels read correctly in right-to-left layouts.
Data Grid
- Escape.
useDataGridtakesonEscapeKeyDown. Callevent.preventDefault()to keep the selection. - Header sort. Picking Asc or Desc in a column header makes it the first sort, like the Data Table.
- Narrow widths and long labels. The filter, sort, and view menus stay readable at narrow widths and with long labels.
Migrating
- Reinstall the Data Table and Data Grid components you use.
- Replace
getDataTableSearchParamswithcreateDataTableConfig, andgetDataTableQuerywithconfig.parse(searchParams). - Remove
getColumnOptionsfrom your columns and passconfigtouseDataTable. - Move
initialState.sorting, the page size,pageSizeOptions, andenableGlobalFilteronto the config. - Replace
queryKeyswith a configid. - Rename variants and column configs using the table above.
- Remove
throttleMsandautoResetPageIndexfromuseDataTable.
November 2026 - Presentation Controls
November 13, 2026
Presentation adds PresentationControls for toolbars and other editor UI outside the slide, built on @diceui/pptx 0.5.
pnpm dlx shadcn@latest add @diceui/presentationControls
PresentationControls wraps editor UI outside the slide, such as a toolbar. Pressing it keeps the selection and text editing, and so does pressing the popovers and menus it renders, even when they portal out. You no longer mark each menu yourself.
<PresentationControls>
<FormattingToolbar />
</PresentationControls>The editing example now wraps its toolbar in it.
Fixes
- Drags. Moving, resizing, rotating, drawing, and marquee selection end where the pointer is released, even when it's released before the last moves render.
- Table cells. A cell range dragged while the table re-renders is kept, and keys typed over selected cells during a re-render are no longer lost.
- Scrolling. Pressing a shape or starting a drawing no longer scrolls the page when the editor is partly off screen.
- Unmounting. A presentation frees its picture URLs and removes the deck's embedded fonts when it unmounts, and
PresentationanduseCreatePresentationStorereset their store.
Breaking changes
-
Controls attribute.
data-pptx-keep-selectionis nowdata-presentation-controls, andKEEP_SELECTION_ATTRIBUTEis nowCONTROLS_ATTRIBUTE. Wrap toolbars inPresentationControlsinstead of marking them.<div data-pptx-keep-selection=""> // [!code --] <PresentationControls> // [!code ++] <FormattingToolbar /> </div> // [!code --] </PresentationControls> -
Overlay part attributes. The overlay parts carry
data-presentation-*attributes, matching the--presentation-*CSS variables.Before After [data-selection-box][data-presentation-selection-box][data-resize-handle][data-presentation-resize-handle][data-rotate-handle][data-presentation-rotate-handle][data-snap-guide][data-presentation-snap-guide][data-marquee][data-presentation-marquee] -
Slide index attribute. Slide wrappers carry
data-pptx-slide-indexinstead ofdata-slide-index.
Migrating
- Update
@diceui/pptxto 0.5 and reinstall the Presentation component. - Wrap toolbars in
PresentationControls, and removedata-pptx-keep-selectionfrom them and their menus. - Rename any remaining
data-pptx-keep-selectiontodata-presentation-controls, andKEEP_SELECTION_ATTRIBUTEtoCONTROLS_ATTRIBUTE. - Rename overlay part selectors using the table above, and
[data-slide-index]to[data-pptx-slide-index].
November 2026 - Query Builder
November 8, 2026
Query Builder builds nested filter rules and groups, and turns them into parameterized SQL.
pnpm dlx shadcn@latest add @diceui/query-builderFeatures
- Composable parts. Build the layout from parts like
QueryBuilderGroup,QueryBuilderRuleListandQueryBuilderRule. Nested groups reuse the root group's layout. - Fields. Each field has a
value, alabeland atype: text, number, date, boolean, select or multi-select, each with its own operators. - Multiple values. Select fields switch from "is" to "is any of" when a second value is picked, like Linear's filters.
- Negated groups.
QueryBuilderNegateturns a group intoNOT (...). - Labels. Pass
labelsto reword or translate the built-in text.
Utilities
formatQueryturns a query into a parameterizedWHEREclause for Postgres, MySQL or SQLite.matchesQueryfilters rows in the browser with the same rules.moveQueryNodeandfindQueryNodemove and find rules and groups, for drag and drop.
Examples
The docs include SQL output, client-side filtering, a Linear-style command filter, and drag and drop with Sortable.
November 2026 - Presentation Tables
November 6, 2026
Presentation now edits tables, built on @diceui/pptx 0.4.
pnpm dlx shadcn@latest add @diceui/presentationTables
- Cells. Press a cell to edit it. Tab and the arrow keys move between cells, and Tab on the last cell adds a row.
- Rows and columns. Insert and delete rows and columns, and drag any border to resize one.
- Selecting cells. Drag across cells or Shift-click to select them, then format, merge, clear, copy, or paste. Ctrl / Cmd + A selects the whole table.
- Styling. Set cell fill, borders, and vertical alignment, and toggle the header row and banded rows.
- Spreadsheets. Pasting cells from Google Sheets or Excel fills the table, and copied cells paste back into them.
useSelection
useSelection adds insertTable, cell, cellRange, changeTable, and setTableCellStyle, and editText takes a cell. The editing example has a button to insert a table.
Migrating
Update @diceui/pptx to 0.4. There are no breaking changes.
November 2026 - Presentation Editing
November 5, 2026
Presentation now covers more of a slide editor, built on @diceui/pptx 0.3.
pnpm dlx shadcn@latest add @diceui/presentationEditing
- Selection. A click selects a shape. Click it again, double-click, or type to edit its text. An empty text box is removed once editing moves elsewhere.
- Snapping. Moving and resizing snap to the slide and to other shapes, with guides. Hold Alt to place freely, or set
snappingandsnapThreshold. - Rotation. Drag the handle above a shape to rotate it. Rotated shapes resize along their own axes.
- Shortcuts. Tab moves between shapes, Ctrl / Cmd + D duplicates, copy, cut, and paste work within and between decks, and Ctrl / Cmd + ] and Ctrl / Cmd + [ arrange.
- Thumbnails. The list keeps at most 50 rendered previews, and pending previews no longer pulse.
Formatting toolbar
useSelection reads the selection and its text formatting, and formats, duplicates, deletes, reorders, and inserts text boxes and shapes. startDrawing arms a draw tool that places a text box or shape where the slide is clicked or dragged. Mark toolbars and their menus with data-pptx-keep-selection so pressing them keeps the selection.
The editing example now has a small toolbar built with it.
Overlay parts
The selection overlay is composable from PresentationSelectionBox, PresentationResizeHandle, PresentationRotateHandle, PresentationSnapGuide, and PresentationMarquee. PresentationSelection renders all of them by default.
<PresentationSelection>
<PresentationSelectionBox>
<PresentationResizeHandle />
<PresentationRotateHandle />
</PresentationSelectionBox>
<PresentationSnapGuide />
<PresentationMarquee />
</PresentationSelection>Breaking changes
undo()returns a promise.useHistory().undoandstore.undo()resolve to a boolean, likeredo().movestarts on drag.modeanddata-modestay"selected"on a press and only become"move"once it drags.- Click selects text boxes. A single click no longer starts editing a text box or placeholder.
- New selection color. The default
--presentation-selectionis#1a73e8instead ofvar(--ring). - Resize handle attribute. Resize handles carry
data-resize-handleinstead ofdata-resize-grip. - New modes.
onModeChangeandmodecan report"rotate"and"draw".
Migrating
- Update
@diceui/pptxto 0.3 and reinstall the Presentation component. - Await or
voidcalls toundo(). - Rename
[data-resize-grip]selectors to[data-resize-handle]. - Set
--presentation-selection: var(--ring)to keep the old selection color.