@kanunilabs/datagrid-react 1.8.1 → 1.8.2

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 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';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, 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';
 
 /** Formats an export menu can offer. */
@@ -950,6 +950,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 +1043,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 +1092,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 +1112,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 +1133,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 +1209,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 +1349,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 +1376,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 +1442,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 {
@@ -1530,6 +1555,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 +1573,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> {
@@ -1884,6 +1911,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 +1937,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>;
@@ -2052,6 +2081,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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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';
+import { GridRowData, DataGridController, GridDataType, RowKey, LookupItem, GridDictionary, StateStoringConfig, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, CardViewOptions, EditMode, RowChange, RowStatusSource, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, RowSaveStatus, 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';
 
 /** Formats an export menu can offer. */
@@ -950,6 +950,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 +1043,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 +1092,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 +1112,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 +1133,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 +1209,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 +1349,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 +1376,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 +1442,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 {
@@ -1530,6 +1555,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 +1573,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> {
@@ -1884,6 +1911,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 +1937,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>;
@@ -2052,6 +2081,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