@kanunilabs/datagrid-react 1.8.1 → 1.8.3

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, CardViewOptions, EditMode, RowChange, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, DataRowNode, ColSpanPlan, SummaryDef, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
-export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, DataRowNode, ColSpanPlan, SummaryDef, RemoteDistinctList, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
+export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, PortalContainer, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ToolbarOptions, ToolbarSearchOptions, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
 type ExportKind = 'csv' | 'excel' | 'excel-selected' | 'pdf';
@@ -744,8 +744,29 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * supports. `false` makes the footer read-only.
      */
     footerMenu?: boolean;
-    /** Toolbar with search, column chooser and export. */
-    toolbar?: boolean;
+    /**
+     * Toolbar with search, column chooser and export. `true` shows all of it;
+     * an object picks the parts and sets the search box up:
+     *
+     *   toolbar={{ export: false, columns: false,
+     *              search: { maxLength: 100, debounce: 300, validate } }}
+     *
+     * Your own buttons: `toolbarItemsBefore` (start) and `toolbarItemsAfter`
+     * (end), e.g. `<GridToolbarButton>`.
+     */
+    toolbar?: boolean | ToolbarOptions;
+    /**
+     * Where the grid draws its popups (header filter, menus, date and lookup
+     * lists, dialogs): an element, or a function returning one. Default
+     * `document.body`.
+     *
+     * Set it when the grid sits in a modal (Radix Dialog and the like): the
+     * modal makes the rest of the page ignore the pointer, so a popup on <body>
+     * cannot be clicked. Pass the modal's content element (one without
+     * `overflow: hidden`). Popups stay in place even when the modal is moved
+     * with a CSS transform. Every popup carries `data-kanuni-portal`.
+     */
+    portalContainer?: PortalContainer;
     /**
      * The toolbar's Columns button — the popup listing HIDDEN columns. Default
      * true. The Enterprise wrapper turns it off when the side bar's Columns
@@ -950,6 +971,12 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
     renderCellContent?: (ctx: CellSlotContext<TRow>) => ReactNode | undefined;
     /** Extra class names per cell (dirty marker, range highlight, invalid). */
     getCellClassName?: (ctx: CellSlotContext<TRow>) => string | undefined;
+    /**
+     * Where `rowStatus` reads each row's save state — `EnterpriseDataGrid`'s
+     * editing engine. With this grid's own `editing` on, its engine answers and
+     * this is not asked.
+     */
+    rowStatusSource?: RowStatusSource | null;
     /** Absolutely-positioned layer over the viewport (fill handle, watermark). */
     renderOverlay?: () => ReactNode;
     /** Pointer down on a cell, with the view coordinates the range engine needs. */
@@ -1037,6 +1064,8 @@ interface GridHeaderProps<TRow = GridRowData> {
     /** Leading expander column for master-detail (Enterprise). */
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     /** What the row-number column's header shows. Defaults to `#`. */
     rowNumberHeader?: React.ReactNode;
@@ -1084,7 +1113,7 @@ interface GridHeaderProps<TRow = GridRowData> {
     /** Replace a header's label (the Enterprise rename box, G-CORE-06). Undefined = the label. */
     renderHeaderLabel?: (columnId: string) => React.ReactNode | undefined;
 }
-declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, rowNumberColumn, rowNumberHeader, selectAllState, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, onHeaderClick, getHeaderClassName, renderHeaderLabel, }: GridHeaderProps<TRow>): react.JSX.Element;
+declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, rowNumberHeader, selectAllState, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, onHeaderClick, getHeaderClassName, renderHeaderLabel, }: GridHeaderProps<TRow>): react.JSX.Element;
 declare const GridHeader: typeof GridHeaderImpl;
 
 /**
@@ -1104,6 +1133,8 @@ interface GridHeaderBandsProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     /** Height of one band row, in px. Defaults to `BAND_ROW_HEIGHT`. */
     rowHeight?: number;
@@ -1123,7 +1154,7 @@ interface GridHeaderBandsProps<TRow = GridRowData> {
         };
     };
 }
-declare function GridHeaderBandsImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, depth, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandFold, }: GridHeaderBandsProps<TRow>): react.JSX.Element | null;
+declare function GridHeaderBandsImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, depth, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, rowHeight, bandFold, }: GridHeaderBandsProps<TRow>): react.JSX.Element | null;
 declare const GridHeaderBands: typeof GridHeaderBandsImpl;
 
 interface GridRowProps<TRow = GridRowData> {
@@ -1199,6 +1230,19 @@ interface GridRowProps<TRow = GridRowData> {
     rowDrag?: RowDragHandlers;
     /** Which edge to draw the drop line on, or null. */
     dropSide?: 'before' | 'after' | null;
+    /**
+     * `rowStatus.messages`: the content of a message row (a refused save's
+     * reason and its buttons), for the parent row's key.
+     */
+    renderRowMessage?: (rowKey: RowKey, row: TRow) => React.ReactNode;
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
+    /** `rowStatus`: this row's save state, when it has one. */
+    rowStatus?: RowSaveStatus;
+    /** The words a screen reader hears for `rowStatus` (`aria-description`). */
+    rowStatusText?: string;
+    /** `rowStatus.tint`: wash the whole row, not only the marker. */
+    rowStatusTint?: boolean;
     /** Renders the leading checkbox cell. */
     checkboxColumn: boolean;
     /** Renders the leading row-number cell (gap analysis P3.5). */
@@ -1326,7 +1370,7 @@ interface GridRowProps<TRow = GridRowData> {
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
 }
-declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, height, }: GridRowProps<TRow>): react.JSX.Element | null;
+declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, statusColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderRowMessage, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, rowStatus, rowStatusText, rowStatusTint, height, }: GridRowProps<TRow>): react.JSX.Element | null;
 declare const GridRow: typeof GridRowImpl;
 
 interface GridFilterRowProps<TRow = GridRowData> {
@@ -1353,6 +1397,8 @@ interface GridFilterRowProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     placeholder?: string;
     onChange: (columnId: string, raw: string) => void;
@@ -1417,7 +1463,7 @@ interface FilterInputSyncProbe {
  * re-render entirely.
  */
 declare function reconcileFilterInputs(prev: Record<string, string>, probe: FilterInputSyncProbe, columnIds?: readonly string[]): Record<string, string>;
-declare function GridFilterRowImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, values, checkboxColumn, detailColumn, rowNumberColumn, placeholder, onChange, onCommit, periodSuggestions, periodListId, operators, onOperatorChange, renderCustom, }: GridFilterRowProps<TRow>): react.JSX.Element;
+declare function GridFilterRowImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, values, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, placeholder, onChange, onCommit, periodSuggestions, periodListId, operators, onOperatorChange, renderCustom, }: GridFilterRowProps<TRow>): react.JSX.Element;
 declare const GridFilterRow: typeof GridFilterRowImpl;
 
 interface DistinctEntry {
@@ -1471,9 +1517,16 @@ interface GridHeaderFilterPopupProps {
      * matched nothing even though the value exists.
      */
     onSearch?: (needle: string) => void;
+    /**
+     * A server-side list, loaded in pieces (see `RemoteDistinctList`). When set,
+     * the popup draws THAT instead of `entries`: the scroll bar is as long as the
+     * server's list, the search box searches on the server, and Select all /
+     * Clear / ticks are the pager's ("everything except these").
+     */
+    pager?: RemoteDistinctList;
     labels?: Partial<Record<'search' | 'selectAll' | 'clear' | 'apply' | 'cancel' | 'blank' | 'noMatch' | 'loading' | 'truncated', string>>;
 }
-declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, truncated, onSearch, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
+declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, truncated, onSearch, pager, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
 
 interface GridContextMenuProps<TContext> {
     x: number;
@@ -1530,6 +1583,8 @@ interface GridFooterRowProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     /** Opens the aggregation menu for a column. */
     onPickSummary?: (columnId: string, event: React.MouseEvent) => void;
@@ -1546,7 +1601,7 @@ interface GridFooterRowProps<TRow = GridRowData> {
     /** Header-height rows between this row and its edge. See GridPinnedRows. */
     headerRowsBetween?: number;
 }
-declare function GridFooterRowImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, defs, values, checkboxColumn, detailColumn, rowNumberColumn, onPickSummary, emptyHint, position, bandOffset, headerRowsBetween, }: GridFooterRowProps<TRow>): react.JSX.Element;
+declare function GridFooterRowImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, defs, values, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, onPickSummary, emptyHint, position, bandOffset, headerRowsBetween, }: GridFooterRowProps<TRow>): react.JSX.Element;
 declare const GridFooterRow: typeof GridFooterRowImpl;
 
 interface GridFilterPanelProps<TRow = GridRowData> {
@@ -1603,9 +1658,16 @@ interface GridToolbarProps<TRow = GridRowData> {
     itemsAfter?: React.ReactNode;
     /** Milliseconds to wait after the last keystroke. Default 200. */
     searchDebounce?: number;
+    /**
+     * The search box's settings (`toolbar={{ search: {...} }}`): placeholder,
+     * maxLength, debounce (wins over `searchDebounce`), applyOnBlur, validate.
+     */
+    searchOptions?: ToolbarSearchOptions;
+    /** The export menu. Default true; false leaves it out whatever the formats. */
+    exportMenu?: boolean;
     labels?: Partial<Record<'search' | 'csv' | 'excel' | 'excelSelected' | 'pdf' | 'columns' | 'exporting' | 'exportMenu', string>>;
 }
-declare function GridToolbarImpl<TRow = GridRowData>({ controller, search, exportCsv, exportExcel, exportPdf, columnChooser, dark, onOpenColumnChooser, itemsBefore, itemsAfter, searchDebounce, labels, }: GridToolbarProps<TRow>): react.JSX.Element;
+declare function GridToolbarImpl<TRow = GridRowData>({ controller, search, exportCsv, exportExcel, exportPdf, columnChooser, dark, onOpenColumnChooser, itemsBefore, itemsAfter, searchDebounce, searchOptions, exportMenu, labels, }: GridToolbarProps<TRow>): react.JSX.Element;
 declare const GridToolbar: typeof GridToolbarImpl;
 
 /** A command button's icon — the shared paths of `toolbarIcons.ts` (see there for why). */
@@ -1614,6 +1676,26 @@ declare function ToolbarIcon({ name, size }: {
     size?: number;
 }): react.JSX.Element;
 
+interface GridToolbarButtonProps {
+    /** The glyph, e.g. an inline SVG or `<ToolbarIcon name="columns" />`. */
+    icon: ReactNode;
+    /** The button's name: its accessible name and the start of its tooltip. */
+    label: string;
+    /** Keyboard shortcut shown in the tooltip ("Export (Ctrl+E)") and as `aria-keyshortcuts`. */
+    shortcut?: string;
+    /**
+     * Set while the button cannot be used: it reads as unavailable, ignores
+     * clicks, and the tooltip and screen reader give this reason.
+     */
+    disabledReason?: string;
+    /** Show the label beside the icon. Default false (icon only). */
+    showLabel?: boolean;
+    onClick?: () => void;
+    /** `data-testid` on the button. */
+    testId?: string;
+}
+declare function GridToolbarButton({ icon, label, shortcut, disabledReason, showLabel, onClick, testId, }: GridToolbarButtonProps): react.JSX.Element;
+
 interface GridColumnChooserProps<TRow = GridRowData> {
     controller: DataGridController<TRow>;
     /** Passed in so the panel re-renders when visibility changes. */
@@ -1884,6 +1966,8 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     rowHeight: number;
     /** Pixels of BAND rows above. Zero on a grid without column bands. */
@@ -1908,7 +1992,7 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
      */
     ariaRowBase: number;
 }
-declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, rowKeys, onUserRowContextMenu, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
+declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, rowKeys, onUserRowContextMenu, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
 declare const GridPinnedRows: typeof GridPinnedRowsImpl;
 
 type UseDataGridOptions<TRow = GridRowData> = DataGridCoreConfig<TRow>;
@@ -1983,9 +2067,16 @@ interface GridSurfaceProviderProps {
     theme?: GridThemeName;
     density?: GridDensity;
     palette?: GridPaletteName;
+    /** Where popups are drawn (the grid's `portalContainer`). Default <body>. */
+    portalContainer?: PortalContainer;
     children: ReactNode;
 }
-declare function GridSurfaceProvider({ theme, density, palette, children, }: GridSurfaceProviderProps): react.JSX.Element;
+declare function GridSurfaceProvider({ theme, density, palette, portalContainer, children, }: GridSurfaceProviderProps): react.JSX.Element;
+/**
+ * The element a popup is portalled into, read when the popup opens: <body>,
+ * or the host inside the grid's `portalContainer` (core `portalTarget`).
+ */
+declare function useGridPortalTarget(): () => HTMLElement;
 /**
  * The theme + density modifier classes for a surface rendered outside the grid.
  * `''` when the grid is unthemed, so appending it is always safe.
@@ -2052,6 +2143,12 @@ interface UseGridEditingOptions<TRow = GridRowData> {
     confirmDeleteMessage?: string;
     /** Disables editing entirely (`editing={{ enabled: false }}`). */
     enabled?: boolean;
+    /**
+     * How long a row reads `'saved'` after its save (`engine.getRowStatus`),
+     * in ms; 0 never shows it. Left out, the engine's default (1500) stays.
+     * The grids pass `rowStatus.savedDuration`, or 0 when `rowStatus` is off.
+     */
+    savedDuration?: number;
     /**
      * `editing.range` — the rectangle, the fill handle and the clipboard
      * gestures (cut / paste). Default true. Off means Ctrl+X and Ctrl+V are left
@@ -2411,4 +2508,4 @@ interface GridDialogProps {
 }
 declare function GridDialog({ open, title, message, cancelLabel, confirmLabel, danger, dark, onConfirm, onCancel, }: GridDialogProps): react.ReactPortal | null;
 
-export { type AlignedGridsApi, BAND_ROW_HEIGHT, type BatchSaveError, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type CellTooltipOptions, DEFAULT_EDIT_FORM_LABELS, DEFAULT_HEADER_MENU_LABELS, DataGrid, type DataGridProps, type DistinctEntry, type EditFormField, type EditFormLabels, type EditModes, type EditorRenderContext, type ExportOutcome, type FilterRenderContext, GridCellEditor, type GridCellEditorProps, GridColumnChooser, type GridColumnChooserProps, GridContextMenu, type GridContextMenuProps, GridDateEditor, type GridDateEditorProps, GridDialog, type GridDialogProps, GridEditForm, type GridEditFormProps, GridFilterPanel, type GridFilterPanelProps, GridFilterRow, type GridFilterRowProps, GridFooterRow, type GridFooterRowProps, GridGroupPanel, type GridGroupPanelProps, GridHeader, GridHeaderBands, type GridHeaderBandsProps, GridHeaderFilterPopup, type GridHeaderFilterPopupProps, type GridHeaderProps, GridLoadingOverlay, type GridLoadingOverlayProps, GridLookupEditor, type GridLookupEditorProps, type GridMenuItem, GridNoteEditor, type GridNotesConfig, GridPager, type GridPagerProps, GridPinnedRows, type GridPinnedRowsProps, GridPopupPanel, type GridPopupPanelProps, GridPortal, type GridPortalProps, GridRow, GridRowEditor, type GridRowEditorProps, type GridRowProps, GridSummaryBar, type GridSummaryBarProps, GridSurfaceProvider, type GridSurfaceProviderProps, GridTextProvider, type GridTextProviderProps, GridToolbar, type GridToolbarProps, GridTooltip, type GridTooltipConfig, type GridTooltipProps, type HeaderMenuContext, type HeaderMenuDeps, type HeaderMenuLabels, type HeaderRenderContext, type NoteCellContext, PRINT_MAX_ROWS, type PendingDelete, type PrintLayoutOptions, type PrintLayoutState, ROW_DRAG_MIME, type RangeApi, type ReactColumnRuntime, type ReactGridColumnDef, type RowDragConfig, type RowDragHandlers, type RowDragPayload, type RowDropEvent, type RowLookupMap, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, SHORTCUT_COPY, SHORTCUT_CUT, SHORTCUT_PASTE, type SelectionStats, ToolbarIcon, type TooltipState, type UseDataGridOptions, type UseDataGridResult, type UseEditModesOptions, type UseGridEditingOptions, type UseGridEditingResult, buildCellMenuItems, buildHeaderMenu, copyToClipboard, editFormColumnIds, editFormLabels, headerMenuLabels, matchOptions, measureBestFitWidth, reconcileFilterInputs, runGridExport, useAlignedGrids, useAnchoredPopup, useCellTooltip, useDataGrid, useEditModes, useGridChartBoxData, useGridChartData, useGridChartXYData, useGridEditing, useGridSurfaceClass, useGridText, usePrintLayout, useRowDrag, useStateStoring, writeClipboardText };
+export { type AlignedGridsApi, BAND_ROW_HEIGHT, type BatchSaveError, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type CellTooltipOptions, DEFAULT_EDIT_FORM_LABELS, DEFAULT_HEADER_MENU_LABELS, DataGrid, type DataGridProps, type DistinctEntry, type EditFormField, type EditFormLabels, type EditModes, type EditorRenderContext, type ExportOutcome, type FilterRenderContext, GridCellEditor, type GridCellEditorProps, GridColumnChooser, type GridColumnChooserProps, GridContextMenu, type GridContextMenuProps, GridDateEditor, type GridDateEditorProps, GridDialog, type GridDialogProps, GridEditForm, type GridEditFormProps, GridFilterPanel, type GridFilterPanelProps, GridFilterRow, type GridFilterRowProps, GridFooterRow, type GridFooterRowProps, GridGroupPanel, type GridGroupPanelProps, GridHeader, GridHeaderBands, type GridHeaderBandsProps, GridHeaderFilterPopup, type GridHeaderFilterPopupProps, type GridHeaderProps, GridLoadingOverlay, type GridLoadingOverlayProps, GridLookupEditor, type GridLookupEditorProps, type GridMenuItem, GridNoteEditor, type GridNotesConfig, GridPager, type GridPagerProps, GridPinnedRows, type GridPinnedRowsProps, GridPopupPanel, type GridPopupPanelProps, GridPortal, type GridPortalProps, GridRow, GridRowEditor, type GridRowEditorProps, type GridRowProps, GridSummaryBar, type GridSummaryBarProps, GridSurfaceProvider, type GridSurfaceProviderProps, GridTextProvider, type GridTextProviderProps, GridToolbar, GridToolbarButton, type GridToolbarButtonProps, type GridToolbarProps, GridTooltip, type GridTooltipConfig, type GridTooltipProps, type HeaderMenuContext, type HeaderMenuDeps, type HeaderMenuLabels, type HeaderRenderContext, type NoteCellContext, PRINT_MAX_ROWS, type PendingDelete, type PrintLayoutOptions, type PrintLayoutState, ROW_DRAG_MIME, type RangeApi, type ReactColumnRuntime, type ReactGridColumnDef, type RowDragConfig, type RowDragHandlers, type RowDragPayload, type RowDropEvent, type RowLookupMap, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, SHORTCUT_COPY, SHORTCUT_CUT, SHORTCUT_PASTE, type SelectionStats, ToolbarIcon, type TooltipState, type UseDataGridOptions, type UseDataGridResult, type UseEditModesOptions, type UseGridEditingOptions, type UseGridEditingResult, buildCellMenuItems, buildHeaderMenu, copyToClipboard, editFormColumnIds, editFormLabels, headerMenuLabels, matchOptions, measureBestFitWidth, reconcileFilterInputs, runGridExport, useAlignedGrids, useAnchoredPopup, useCellTooltip, useDataGrid, useEditModes, useGridChartBoxData, useGridChartData, useGridChartXYData, useGridEditing, useGridPortalTarget, useGridSurfaceClass, useGridText, usePrintLayout, useRowDrag, useStateStoring, writeClipboardText };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, CardViewOptions, EditMode, RowChange, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, DataRowNode, ColSpanPlan, SummaryDef, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
-export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ToolbarOptions, PortalContainer, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, DataRowNode, ColSpanPlan, SummaryDef, RemoteDistinctList, ToolbarSearchOptions, ToolbarIconName, ColumnState, BusyPhase, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditingEngine, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, RowEditSession, LookupMatchMode } from '@kanunilabs/datagrid-core';
+export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, CustomFilterOperator, CustomFilterOperatorId, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, PortalContainer, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ToolbarOptions, ToolbarSearchOptions, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
 type ExportKind = 'csv' | 'excel' | 'excel-selected' | 'pdf';
@@ -744,8 +744,29 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * supports. `false` makes the footer read-only.
      */
     footerMenu?: boolean;
-    /** Toolbar with search, column chooser and export. */
-    toolbar?: boolean;
+    /**
+     * Toolbar with search, column chooser and export. `true` shows all of it;
+     * an object picks the parts and sets the search box up:
+     *
+     *   toolbar={{ export: false, columns: false,
+     *              search: { maxLength: 100, debounce: 300, validate } }}
+     *
+     * Your own buttons: `toolbarItemsBefore` (start) and `toolbarItemsAfter`
+     * (end), e.g. `<GridToolbarButton>`.
+     */
+    toolbar?: boolean | ToolbarOptions;
+    /**
+     * Where the grid draws its popups (header filter, menus, date and lookup
+     * lists, dialogs): an element, or a function returning one. Default
+     * `document.body`.
+     *
+     * Set it when the grid sits in a modal (Radix Dialog and the like): the
+     * modal makes the rest of the page ignore the pointer, so a popup on <body>
+     * cannot be clicked. Pass the modal's content element (one without
+     * `overflow: hidden`). Popups stay in place even when the modal is moved
+     * with a CSS transform. Every popup carries `data-kanuni-portal`.
+     */
+    portalContainer?: PortalContainer;
     /**
      * The toolbar's Columns button — the popup listing HIDDEN columns. Default
      * true. The Enterprise wrapper turns it off when the side bar's Columns
@@ -950,6 +971,12 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
     renderCellContent?: (ctx: CellSlotContext<TRow>) => ReactNode | undefined;
     /** Extra class names per cell (dirty marker, range highlight, invalid). */
     getCellClassName?: (ctx: CellSlotContext<TRow>) => string | undefined;
+    /**
+     * Where `rowStatus` reads each row's save state — `EnterpriseDataGrid`'s
+     * editing engine. With this grid's own `editing` on, its engine answers and
+     * this is not asked.
+     */
+    rowStatusSource?: RowStatusSource | null;
     /** Absolutely-positioned layer over the viewport (fill handle, watermark). */
     renderOverlay?: () => ReactNode;
     /** Pointer down on a cell, with the view coordinates the range engine needs. */
@@ -1037,6 +1064,8 @@ interface GridHeaderProps<TRow = GridRowData> {
     /** Leading expander column for master-detail (Enterprise). */
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     /** What the row-number column's header shows. Defaults to `#`. */
     rowNumberHeader?: React.ReactNode;
@@ -1084,7 +1113,7 @@ interface GridHeaderProps<TRow = GridRowData> {
     /** Replace a header's label (the Enterprise rename box, G-CORE-06). Undefined = the label. */
     renderHeaderLabel?: (columnId: string) => React.ReactNode | undefined;
 }
-declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, rowNumberColumn, rowNumberHeader, selectAllState, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, onHeaderClick, getHeaderClassName, renderHeaderLabel, }: GridHeaderProps<TRow>): react.JSX.Element;
+declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, rowNumberHeader, selectAllState, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, onHeaderClick, getHeaderClassName, renderHeaderLabel, }: GridHeaderProps<TRow>): react.JSX.Element;
 declare const GridHeader: typeof GridHeaderImpl;
 
 /**
@@ -1104,6 +1133,8 @@ interface GridHeaderBandsProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     /** Height of one band row, in px. Defaults to `BAND_ROW_HEIGHT`. */
     rowHeight?: number;
@@ -1123,7 +1154,7 @@ interface GridHeaderBandsProps<TRow = GridRowData> {
         };
     };
 }
-declare function GridHeaderBandsImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, depth, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandFold, }: GridHeaderBandsProps<TRow>): react.JSX.Element | null;
+declare function GridHeaderBandsImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, depth, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, rowHeight, bandFold, }: GridHeaderBandsProps<TRow>): react.JSX.Element | null;
 declare const GridHeaderBands: typeof GridHeaderBandsImpl;
 
 interface GridRowProps<TRow = GridRowData> {
@@ -1199,6 +1230,19 @@ interface GridRowProps<TRow = GridRowData> {
     rowDrag?: RowDragHandlers;
     /** Which edge to draw the drop line on, or null. */
     dropSide?: 'before' | 'after' | null;
+    /**
+     * `rowStatus.messages`: the content of a message row (a refused save's
+     * reason and its buttons), for the parent row's key.
+     */
+    renderRowMessage?: (rowKey: RowKey, row: TRow) => React.ReactNode;
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
+    /** `rowStatus`: this row's save state, when it has one. */
+    rowStatus?: RowSaveStatus;
+    /** The words a screen reader hears for `rowStatus` (`aria-description`). */
+    rowStatusText?: string;
+    /** `rowStatus.tint`: wash the whole row, not only the marker. */
+    rowStatusTint?: boolean;
     /** Renders the leading checkbox cell. */
     checkboxColumn: boolean;
     /** Renders the leading row-number cell (gap analysis P3.5). */
@@ -1326,7 +1370,7 @@ interface GridRowProps<TRow = GridRowData> {
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
 }
-declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, height, }: GridRowProps<TRow>): react.JSX.Element | null;
+declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, statusColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderRowMessage, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, rowStatus, rowStatusText, rowStatusTint, height, }: GridRowProps<TRow>): react.JSX.Element | null;
 declare const GridRow: typeof GridRowImpl;
 
 interface GridFilterRowProps<TRow = GridRowData> {
@@ -1353,6 +1397,8 @@ interface GridFilterRowProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     placeholder?: string;
     onChange: (columnId: string, raw: string) => void;
@@ -1417,7 +1463,7 @@ interface FilterInputSyncProbe {
  * re-render entirely.
  */
 declare function reconcileFilterInputs(prev: Record<string, string>, probe: FilterInputSyncProbe, columnIds?: readonly string[]): Record<string, string>;
-declare function GridFilterRowImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, values, checkboxColumn, detailColumn, rowNumberColumn, placeholder, onChange, onCommit, periodSuggestions, periodListId, operators, onOperatorChange, renderCustom, }: GridFilterRowProps<TRow>): react.JSX.Element;
+declare function GridFilterRowImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, values, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, placeholder, onChange, onCommit, periodSuggestions, periodListId, operators, onOperatorChange, renderCustom, }: GridFilterRowProps<TRow>): react.JSX.Element;
 declare const GridFilterRow: typeof GridFilterRowImpl;
 
 interface DistinctEntry {
@@ -1471,9 +1517,16 @@ interface GridHeaderFilterPopupProps {
      * matched nothing even though the value exists.
      */
     onSearch?: (needle: string) => void;
+    /**
+     * A server-side list, loaded in pieces (see `RemoteDistinctList`). When set,
+     * the popup draws THAT instead of `entries`: the scroll bar is as long as the
+     * server's list, the search box searches on the server, and Select all /
+     * Clear / ticks are the pager's ("everything except these").
+     */
+    pager?: RemoteDistinctList;
     labels?: Partial<Record<'search' | 'selectAll' | 'clear' | 'apply' | 'cancel' | 'blank' | 'noMatch' | 'loading' | 'truncated', string>>;
 }
-declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, truncated, onSearch, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
+declare function GridHeaderFilterPopup({ gridId, columnId, headerLabel, entries, initialSelected, anchor, loading, dark, onApply, onClose, truncated, onSearch, pager, labels, }: GridHeaderFilterPopupProps): react.JSX.Element;
 
 interface GridContextMenuProps<TContext> {
     x: number;
@@ -1530,6 +1583,8 @@ interface GridFooterRowProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     /** Opens the aggregation menu for a column. */
     onPickSummary?: (columnId: string, event: React.MouseEvent) => void;
@@ -1546,7 +1601,7 @@ interface GridFooterRowProps<TRow = GridRowData> {
     /** Header-height rows between this row and its edge. See GridPinnedRows. */
     headerRowsBetween?: number;
 }
-declare function GridFooterRowImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, defs, values, checkboxColumn, detailColumn, rowNumberColumn, onPickSummary, emptyHint, position, bandOffset, headerRowsBetween, }: GridFooterRowProps<TRow>): react.JSX.Element;
+declare function GridFooterRowImpl<TRow = GridRowData>({ layout, centerColumns, leadingSpacer, trailingSpacer, defs, values, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, onPickSummary, emptyHint, position, bandOffset, headerRowsBetween, }: GridFooterRowProps<TRow>): react.JSX.Element;
 declare const GridFooterRow: typeof GridFooterRowImpl;
 
 interface GridFilterPanelProps<TRow = GridRowData> {
@@ -1603,9 +1658,16 @@ interface GridToolbarProps<TRow = GridRowData> {
     itemsAfter?: React.ReactNode;
     /** Milliseconds to wait after the last keystroke. Default 200. */
     searchDebounce?: number;
+    /**
+     * The search box's settings (`toolbar={{ search: {...} }}`): placeholder,
+     * maxLength, debounce (wins over `searchDebounce`), applyOnBlur, validate.
+     */
+    searchOptions?: ToolbarSearchOptions;
+    /** The export menu. Default true; false leaves it out whatever the formats. */
+    exportMenu?: boolean;
     labels?: Partial<Record<'search' | 'csv' | 'excel' | 'excelSelected' | 'pdf' | 'columns' | 'exporting' | 'exportMenu', string>>;
 }
-declare function GridToolbarImpl<TRow = GridRowData>({ controller, search, exportCsv, exportExcel, exportPdf, columnChooser, dark, onOpenColumnChooser, itemsBefore, itemsAfter, searchDebounce, labels, }: GridToolbarProps<TRow>): react.JSX.Element;
+declare function GridToolbarImpl<TRow = GridRowData>({ controller, search, exportCsv, exportExcel, exportPdf, columnChooser, dark, onOpenColumnChooser, itemsBefore, itemsAfter, searchDebounce, searchOptions, exportMenu, labels, }: GridToolbarProps<TRow>): react.JSX.Element;
 declare const GridToolbar: typeof GridToolbarImpl;
 
 /** A command button's icon — the shared paths of `toolbarIcons.ts` (see there for why). */
@@ -1614,6 +1676,26 @@ declare function ToolbarIcon({ name, size }: {
     size?: number;
 }): react.JSX.Element;
 
+interface GridToolbarButtonProps {
+    /** The glyph, e.g. an inline SVG or `<ToolbarIcon name="columns" />`. */
+    icon: ReactNode;
+    /** The button's name: its accessible name and the start of its tooltip. */
+    label: string;
+    /** Keyboard shortcut shown in the tooltip ("Export (Ctrl+E)") and as `aria-keyshortcuts`. */
+    shortcut?: string;
+    /**
+     * Set while the button cannot be used: it reads as unavailable, ignores
+     * clicks, and the tooltip and screen reader give this reason.
+     */
+    disabledReason?: string;
+    /** Show the label beside the icon. Default false (icon only). */
+    showLabel?: boolean;
+    onClick?: () => void;
+    /** `data-testid` on the button. */
+    testId?: string;
+}
+declare function GridToolbarButton({ icon, label, shortcut, disabledReason, showLabel, onClick, testId, }: GridToolbarButtonProps): react.JSX.Element;
+
 interface GridColumnChooserProps<TRow = GridRowData> {
     controller: DataGridController<TRow>;
     /** Passed in so the panel re-renders when visibility changes. */
@@ -1884,6 +1966,8 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
     checkboxColumn?: boolean;
     detailColumn?: boolean;
     /** Leading row-number column (gap analysis P3.5). */
+    /** `rowStatus.icons`: the leading status column is showing. */
+    statusColumn?: boolean;
     rowNumberColumn?: boolean;
     rowHeight: number;
     /** Pixels of BAND rows above. Zero on a grid without column bands. */
@@ -1908,7 +1992,7 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
      */
     ariaRowBase: number;
 }
-declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, rowKeys, onUserRowContextMenu, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
+declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, rowKeys, onUserRowContextMenu, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, statusColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
 declare const GridPinnedRows: typeof GridPinnedRowsImpl;
 
 type UseDataGridOptions<TRow = GridRowData> = DataGridCoreConfig<TRow>;
@@ -1983,9 +2067,16 @@ interface GridSurfaceProviderProps {
     theme?: GridThemeName;
     density?: GridDensity;
     palette?: GridPaletteName;
+    /** Where popups are drawn (the grid's `portalContainer`). Default <body>. */
+    portalContainer?: PortalContainer;
     children: ReactNode;
 }
-declare function GridSurfaceProvider({ theme, density, palette, children, }: GridSurfaceProviderProps): react.JSX.Element;
+declare function GridSurfaceProvider({ theme, density, palette, portalContainer, children, }: GridSurfaceProviderProps): react.JSX.Element;
+/**
+ * The element a popup is portalled into, read when the popup opens: <body>,
+ * or the host inside the grid's `portalContainer` (core `portalTarget`).
+ */
+declare function useGridPortalTarget(): () => HTMLElement;
 /**
  * The theme + density modifier classes for a surface rendered outside the grid.
  * `''` when the grid is unthemed, so appending it is always safe.
@@ -2052,6 +2143,12 @@ interface UseGridEditingOptions<TRow = GridRowData> {
     confirmDeleteMessage?: string;
     /** Disables editing entirely (`editing={{ enabled: false }}`). */
     enabled?: boolean;
+    /**
+     * How long a row reads `'saved'` after its save (`engine.getRowStatus`),
+     * in ms; 0 never shows it. Left out, the engine's default (1500) stays.
+     * The grids pass `rowStatus.savedDuration`, or 0 when `rowStatus` is off.
+     */
+    savedDuration?: number;
     /**
      * `editing.range` — the rectangle, the fill handle and the clipboard
      * gestures (cut / paste). Default true. Off means Ctrl+X and Ctrl+V are left
@@ -2411,4 +2508,4 @@ interface GridDialogProps {
 }
 declare function GridDialog({ open, title, message, cancelLabel, confirmLabel, danger, dark, onConfirm, onCancel, }: GridDialogProps): react.ReactPortal | null;
 
-export { type AlignedGridsApi, BAND_ROW_HEIGHT, type BatchSaveError, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type CellTooltipOptions, DEFAULT_EDIT_FORM_LABELS, DEFAULT_HEADER_MENU_LABELS, DataGrid, type DataGridProps, type DistinctEntry, type EditFormField, type EditFormLabels, type EditModes, type EditorRenderContext, type ExportOutcome, type FilterRenderContext, GridCellEditor, type GridCellEditorProps, GridColumnChooser, type GridColumnChooserProps, GridContextMenu, type GridContextMenuProps, GridDateEditor, type GridDateEditorProps, GridDialog, type GridDialogProps, GridEditForm, type GridEditFormProps, GridFilterPanel, type GridFilterPanelProps, GridFilterRow, type GridFilterRowProps, GridFooterRow, type GridFooterRowProps, GridGroupPanel, type GridGroupPanelProps, GridHeader, GridHeaderBands, type GridHeaderBandsProps, GridHeaderFilterPopup, type GridHeaderFilterPopupProps, type GridHeaderProps, GridLoadingOverlay, type GridLoadingOverlayProps, GridLookupEditor, type GridLookupEditorProps, type GridMenuItem, GridNoteEditor, type GridNotesConfig, GridPager, type GridPagerProps, GridPinnedRows, type GridPinnedRowsProps, GridPopupPanel, type GridPopupPanelProps, GridPortal, type GridPortalProps, GridRow, GridRowEditor, type GridRowEditorProps, type GridRowProps, GridSummaryBar, type GridSummaryBarProps, GridSurfaceProvider, type GridSurfaceProviderProps, GridTextProvider, type GridTextProviderProps, GridToolbar, type GridToolbarProps, GridTooltip, type GridTooltipConfig, type GridTooltipProps, type HeaderMenuContext, type HeaderMenuDeps, type HeaderMenuLabels, type HeaderRenderContext, type NoteCellContext, PRINT_MAX_ROWS, type PendingDelete, type PrintLayoutOptions, type PrintLayoutState, ROW_DRAG_MIME, type RangeApi, type ReactColumnRuntime, type ReactGridColumnDef, type RowDragConfig, type RowDragHandlers, type RowDragPayload, type RowDropEvent, type RowLookupMap, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, SHORTCUT_COPY, SHORTCUT_CUT, SHORTCUT_PASTE, type SelectionStats, ToolbarIcon, type TooltipState, type UseDataGridOptions, type UseDataGridResult, type UseEditModesOptions, type UseGridEditingOptions, type UseGridEditingResult, buildCellMenuItems, buildHeaderMenu, copyToClipboard, editFormColumnIds, editFormLabels, headerMenuLabels, matchOptions, measureBestFitWidth, reconcileFilterInputs, runGridExport, useAlignedGrids, useAnchoredPopup, useCellTooltip, useDataGrid, useEditModes, useGridChartBoxData, useGridChartData, useGridChartXYData, useGridEditing, useGridSurfaceClass, useGridText, usePrintLayout, useRowDrag, useStateStoring, writeClipboardText };
+export { type AlignedGridsApi, BAND_ROW_HEIGHT, type BatchSaveError, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type CellTooltipOptions, DEFAULT_EDIT_FORM_LABELS, DEFAULT_HEADER_MENU_LABELS, DataGrid, type DataGridProps, type DistinctEntry, type EditFormField, type EditFormLabels, type EditModes, type EditorRenderContext, type ExportOutcome, type FilterRenderContext, GridCellEditor, type GridCellEditorProps, GridColumnChooser, type GridColumnChooserProps, GridContextMenu, type GridContextMenuProps, GridDateEditor, type GridDateEditorProps, GridDialog, type GridDialogProps, GridEditForm, type GridEditFormProps, GridFilterPanel, type GridFilterPanelProps, GridFilterRow, type GridFilterRowProps, GridFooterRow, type GridFooterRowProps, GridGroupPanel, type GridGroupPanelProps, GridHeader, GridHeaderBands, type GridHeaderBandsProps, GridHeaderFilterPopup, type GridHeaderFilterPopupProps, type GridHeaderProps, GridLoadingOverlay, type GridLoadingOverlayProps, GridLookupEditor, type GridLookupEditorProps, type GridMenuItem, GridNoteEditor, type GridNotesConfig, GridPager, type GridPagerProps, GridPinnedRows, type GridPinnedRowsProps, GridPopupPanel, type GridPopupPanelProps, GridPortal, type GridPortalProps, GridRow, GridRowEditor, type GridRowEditorProps, type GridRowProps, GridSummaryBar, type GridSummaryBarProps, GridSurfaceProvider, type GridSurfaceProviderProps, GridTextProvider, type GridTextProviderProps, GridToolbar, GridToolbarButton, type GridToolbarButtonProps, type GridToolbarProps, GridTooltip, type GridTooltipConfig, type GridTooltipProps, type HeaderMenuContext, type HeaderMenuDeps, type HeaderMenuLabels, type HeaderRenderContext, type NoteCellContext, PRINT_MAX_ROWS, type PendingDelete, type PrintLayoutOptions, type PrintLayoutState, ROW_DRAG_MIME, type RangeApi, type ReactColumnRuntime, type ReactGridColumnDef, type RowDragConfig, type RowDragHandlers, type RowDragPayload, type RowDropEvent, type RowLookupMap, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, SHORTCUT_COPY, SHORTCUT_CUT, SHORTCUT_PASTE, type SelectionStats, ToolbarIcon, type TooltipState, type UseDataGridOptions, type UseDataGridResult, type UseEditModesOptions, type UseGridEditingOptions, type UseGridEditingResult, buildCellMenuItems, buildHeaderMenu, copyToClipboard, editFormColumnIds, editFormLabels, headerMenuLabels, matchOptions, measureBestFitWidth, reconcileFilterInputs, runGridExport, useAlignedGrids, useAnchoredPopup, useCellTooltip, useDataGrid, useEditModes, useGridChartBoxData, useGridChartData, useGridChartXYData, useGridEditing, useGridPortalTarget, useGridSurfaceClass, useGridText, usePrintLayout, useRowDrag, useStateStoring, writeClipboardText };