Skip to content
Dice UI

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. getDataTableSearchParams and getDataTableQuery are 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 of DataTableColumnConfigsQuery<typeof columnConfigs>.

  • Columns read the config. getColumnOptions is removed. Pass the config to useDataTable and 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. useDataTable also takes inline options, like config: { 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] }); 
  • id replaces queryKeys. Give the config an id to 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.

    BeforeAfter
    isSortable: falseenableSorting: false
    "multi-select""select"
    "select" (one option)"select" with multiple: false in the column meta
    "number" with filter: "range""number", with min and max in the column meta for the slider
    "date" with filter: "range""date"
  • Removed hook props. throttleMs and autoResetPageIndex are removed. debounceMs only applies with shallow: false in server mode, and clearOnDefault now defaults to true.

  • Removed helpers. isRelativeToToday and the DataTableQueryKeys type are removed.

Data Table

  • Global filter in the URL. The global filter is stored as ?search= and reaches the server as query.globalFilter. Pass globalFilterPlaceholder to either toolbar to show a search input.
  • Sticky header. Set stickyHeader on DataTable to 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() in onEscapeKeyDown to 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 accessorKey alone now sort and filter through the URL, and DataTableColumnHeader reads its label from meta.label when 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. useDataGrid takes onEscapeKeyDown. Call event.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

  1. Reinstall the Data Table and Data Grid components you use.
  2. Replace getDataTableSearchParams with createDataTableConfig, and getDataTableQuery with config.parse(searchParams).
  3. Remove getColumnOptions from your columns and pass config to useDataTable.
  4. Move initialState.sorting, the page size, pageSizeOptions, and enableGlobalFilter onto the config.
  5. Replace queryKeys with a config id.
  6. Rename variants and column configs using the table above.
  7. Remove throttleMs and autoResetPageIndex from useDataTable.

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/presentation

Controls

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 Presentation and useCreatePresentationStore reset their store.

Breaking changes

  • Controls attribute. data-pptx-keep-selection is now data-presentation-controls, and KEEP_SELECTION_ATTRIBUTE is now CONTROLS_ATTRIBUTE. Wrap toolbars in PresentationControls instead 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.

    BeforeAfter
    [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-index instead of data-slide-index.

Migrating

  1. Update @diceui/pptx to 0.5 and reinstall the Presentation component.
  2. Wrap toolbars in PresentationControls, and remove data-pptx-keep-selection from them and their menus.
  3. Rename any remaining data-pptx-keep-selection to data-presentation-controls, and KEEP_SELECTION_ATTRIBUTE to CONTROLS_ATTRIBUTE.
  4. 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-builder

Features

  • Composable parts. Build the layout from parts like QueryBuilderGroup, QueryBuilderRuleList and QueryBuilderRule. Nested groups reuse the root group's layout.
  • Fields. Each field has a value, a label and a type: 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. QueryBuilderNegate turns a group into NOT (...).
  • Labels. Pass labels to reword or translate the built-in text.

Utilities

  • formatQuery turns a query into a parameterized WHERE clause for Postgres, MySQL or SQLite.
  • matchesQuery filters rows in the browser with the same rules.
  • moveQueryNode and findQueryNode move 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/presentation

Tables

  • 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/presentation

Editing

  • 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 snapping and snapThreshold.
  • 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().undo and store.undo() resolve to a boolean, like redo().
  • move starts on drag. mode and data-mode stay "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-selection is #1a73e8 instead of var(--ring).
  • Resize handle attribute. Resize handles carry data-resize-handle instead of data-resize-grip.
  • New modes. onModeChange and mode can report "rotate" and "draw".

Migrating

  1. Update @diceui/pptx to 0.3 and reinstall the Presentation component.
  2. Await or void calls to undo().
  3. Rename [data-resize-grip] selectors to [data-resize-handle].
  4. Set --presentation-selection: var(--ring) to keep the old selection color.

More Updates

On this page