@kanunilabs/datagrid-react 1.8.0 → 1.8.2

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { GridRowData, DataGridController, StateStoringConfig, RowKey, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, CardViewOptions, RowChange, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, DataRowNode, ColSpanPlan, SummaryDef, ToolbarIconName, ColumnState, BusyPhase, GridDictionary, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel, CellRange, RangeSelectionEngine, ColumnSelectMode, EditMode, ValidationRule, CrudHandlers, EditingPermissions, NewRowPosition, EditingEngine, GridDataType, LookupItem, 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. */
@@ -20,6 +20,86 @@ interface ExportOutcome {
  */
 declare function runGridExport<TRow = GridRowData>(controller: DataGridController<TRow>, kind: ExportKind): Promise<ExportOutcome>;
 
+/**
+ * Lookup items per column of the open row.
+ * `undefined` = not a lookup column · `null` = loading · array = ready.
+ */
+type RowLookupMap = Record<string, readonly LookupItem[] | null | undefined>;
+interface EditFormField<TRow = GridRowData> {
+    columnId: string;
+    label: string;
+    dataType: GridDataType | undefined;
+    def: ReactGridColumnDef<TRow> | undefined;
+    /** False for a column the permissions do not allow on this row. */
+    editable: boolean;
+}
+interface GridEditFormProps<TRow = GridRowData> {
+    rowKey: RowKey;
+    fields: readonly EditFormField<TRow>[];
+    /** Current (pending) value per column. */
+    getValue: (columnId: string) => unknown;
+    /** Validation message per column id; only invalid columns appear. */
+    errors: Record<string, string>;
+    /**
+     * Lookup combos per column (Enterprise). A column absent from the map gets
+     * no list; omitted entirely, no field is a combo.
+     */
+    lookups?: RowLookupMap;
+    /**
+     * Let a column's `renderEditor` draw its field (Enterprise). Default false:
+     * the field shows the value read-only instead.
+     */
+    customEditors?: boolean;
+    /** The row with pending edits applied — what a custom editor should read. */
+    row: TRow | undefined;
+    /** True while the save is in flight; the form goes read-only. */
+    saving: boolean;
+    /** Shown above the fields when the last save was rejected. */
+    saveError?: string | null;
+    isNew: boolean;
+    dark?: boolean;
+    /** Rendered as a modal dialog rather than inline. */
+    popup?: boolean;
+    /**
+     * Drawn INSIDE the grid, in the row flow (`mode: 'form'`, gap D5a).
+     *
+     * Only changes the chrome: a panel that already sits in a row slot needs no
+     * outer margin, drop shadow or rounded corners — those exist to lift a
+     * floating panel off the page, and here they would draw a second card
+     * inside the one the row already is.
+     */
+    inline?: boolean;
+    /**
+     * Reports the height the form WANTS, in px, once it is in the DOM.
+     *
+     * The in-grid form is given a slot measured in whole rows, so somebody has
+     * to decide how many. Measured here because this is where the DOM is, and
+     * measured through the scrolling field area — `scrollHeight` is the content,
+     * `clientHeight` the space it was given — so the answer does not depend on
+     * the slot already assigned. Reading the panel's own height instead would
+     * feed the current slot straight back in and never converge.
+     */
+    onNaturalHeight?: (px: number) => void;
+    labels?: Partial<EditFormLabels>;
+    onChange: (columnId: string, value: unknown) => void;
+    onSave: () => void;
+    onCancel: () => void;
+}
+interface EditFormLabels {
+    save: string;
+    cancel: string;
+    editTitle: string;
+    addTitle: string;
+    saving: string;
+    /** Hint under the buttons. `{key}` is replaced with Ctrl or ⌘. */
+    shortcut: string;
+}
+/** The captions in one language. */
+declare function editFormLabels(t: GridDictionary): EditFormLabels;
+/** English, kept as the constant this package already exported. */
+declare const DEFAULT_EDIT_FORM_LABELS: EditFormLabels;
+declare function GridEditForm<TRow = GridRowData>({ rowKey, fields, getValue, errors, lookups, customEditors, row, saving, saveError, isNew, dark, popup, inline, onNaturalHeight, labels: labelOverrides, onChange, onSave, onCancel, }: GridEditFormProps<TRow>): react.JSX.Element;
+
 declare function useStateStoring<TRow = GridRowData>(controller: DataGridController<TRow>, config: StateStoringConfig | undefined): void;
 
 interface PrintLayoutOptions {
@@ -407,20 +487,43 @@ interface RowMenuContext<TRow = GridRowData> {
     /** Selected row keys at the moment the menu opened. */
     selectedKeys: RowKey[];
 }
-/** Single-cell editing in the Community grid — see `DataGridProps.editing`. */
+/** Editing in the Community grid — see `DataGridProps.editing`. */
 interface DataGridEditingOptions<TRow = GridRowData> {
     /** Default true once `editing` is given. */
     enabled?: boolean;
     /**
-     * Always `'cell'` here — accepted so the same object works in both editions
-     * (`EnterpriseDataGrid` defaults to `'batch'` and adds the other modes).
+     * How edits are made and saved. Default `'cell'` here (`EnterpriseDataGrid`
+     * defaults to `'batch'`); all five are free since 2026-10-16.
+     *
+     * - `'cell'` — one cell at a time, saved on commit.
+     * - `'batch'` — edits collect (marked with a corner triangle) and are saved
+     *   together from the Save button above the grid, or dropped with Cancel.
+     * - `'row'` — double-click (or "Edit row…" in the row menu) opens the whole
+     *   row in place; Enter or Save saves it, Escape or Cancel drops it.
+     * - `'form'` — the row opens as a form under it, in the grid.
+     * - `'popup'` — the row opens as a form in a dialog over the grid.
+     *
+     * In every mode but `'cell'` the grid does not change your data itself:
+     * `onSave` receives the changes and the app writes them (then updates
+     * `dataSource`).
      */
-    mode?: 'cell';
+    mode?: EditMode;
     /**
-     * Persist one committed cell. Called after the value is written to the row;
-     * a rejected promise is reported in the grid and the edit stays visible.
+     * Persist changes: one committed cell in `'cell'` mode, every pending row in
+     * `'batch'`, the open row in `'row'`/`'form'`/`'popup'`. A rejected promise is
+     * reported in the grid and the edits stay.
      */
     onSave?: (changes: RowChange<TRow>[]) => Promise<void> | void;
+    /**
+     * Wording for the form/popup editor (`mode: 'form' | 'popup'`) — the buttons,
+     * the title and the shortcut hint.
+     */
+    formLabels?: Partial<EditFormLabels>;
+    /**
+     * Starting height in px for the in-grid form (`mode: 'form'`), before it has
+     * been measured. Only worth setting to stop the one-frame resize on open.
+     */
+    formHeight?: number;
     /** Typing a printable character on a focused cell opens its editor. Default true. */
     editOnKeyPress?: boolean;
     /** Tab moves between cells inside the grid instead of leaving it. Default true. */
@@ -823,25 +926,36 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      */
     onReady?: (controller: DataGridController<TRow>) => void;
     /**
-     * Edit a cell in place — free in Community since 2026-10-12.
+     * Edit data in the grid — single cells free since 2026-10-12, batch, row,
+     * form and popup editing free since 2026-10-16 (owner decision).
      *
      * Off unless this object is given (`editing={{ onSave }}`); `enabled: false`
-     * turns it off again. Double-click, F2 or typing opens the editor on
-     * an editable column; Enter commits and moves down, Tab moves to the next
-     * editable cell, Esc cancels. Each committed cell is written to its row and
-     * passed to `onSave` — one call per edit — and `cellValueChanged` fires.
+     * turns it off again. In the default `'cell'` mode double-click, F2 or
+     * typing opens the editor on an editable column; Enter commits and moves
+     * down, Tab moves to the next editable cell, Esc cancels. Each committed cell
+     * is written to its row and passed to `onSave` — one call per edit — and
+     * `cellValueChanged` fires. `mode` switches to collecting edits (`'batch'`,
+     * with a Save / Cancel strip above the grid) or to editing a whole row at a
+     * time (`'row'`, `'form'`, `'popup'` — opened by double-click or "Edit row…"
+     * in the row menu); see `DataGridEditingOptions.mode`.
      * A column with `editable: false`, a `lookup` or a `renderEditor` stays
-     * read-only here.
+     * read-only here, in every mode.
      *
-     * Batch, row, form and popup modes, validation rules, add/delete,
-     * per-row permissions, lookup and custom editors, undo/redo, range
-     * selection, fill and paste are `EnterpriseDataGrid`.
+     * Validation rules, `crud` handlers, adding and deleting rows, per-row
+     * permissions, lookup and custom editors, the command column, undo/redo,
+     * range selection, fill and paste are `EnterpriseDataGrid`.
      */
     editing?: DataGridEditingOptions<TRow>;
     /** Replace a cell's content (e.g. with an editor). Return undefined for default. */
     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. */
@@ -888,8 +1002,9 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
     renderDetail?: (row: TRow) => ReactNode;
     /**
      * Body of the in-grid edit form (`mode: 'form'`), rendered in the row flow
-     * under the record it edits. Set by `EnterpriseDataGrid`; the form's position
-     * and height come from `controller.setEditFormRow`.
+     * under the record it edits. Set by `EnterpriseDataGrid`; the free grid's own
+     * `editing.mode: 'form'` fills it when this is left empty. The form's
+     * position and height come from `controller.setEditFormRow`.
      */
     renderEditForm?: (rowKey: RowKey, row: TRow | undefined) => ReactNode;
 }
@@ -928,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;
@@ -975,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;
 
 /**
@@ -995,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;
@@ -1014,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> {
@@ -1090,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). */
@@ -1217,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> {
@@ -1244,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;
@@ -1308,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 {
@@ -1421,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;
@@ -1437,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> {
@@ -1775,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. */
@@ -1799,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>;
@@ -1943,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
@@ -2101,6 +2245,94 @@ interface UseGridEditingResult<TRow = GridRowData> {
 }
 declare function useGridEditing<TRow = GridRowData>(options: UseGridEditingOptions<TRow>): UseGridEditingResult<TRow>;
 
+interface UseEditModesOptions<TRow = GridRowData> {
+    controller: DataGridController<TRow> | null;
+    /** The editing layer the modes draw (`useGridEditing`'s result). */
+    editing: UseGridEditingResult<TRow>;
+    /** The mode in force. */
+    mode: EditMode;
+    /** Editing is on AND drawn (not paused behind cards). */
+    active: boolean;
+    /** The element the row editors are looked up in, to focus one on open. */
+    rootRef: RefObject<HTMLElement | null>;
+    /** The grid's row height in px — a form re-measure smaller than a row is noise. */
+    rowHeight: number;
+    /** Wording for the form/popup editor. */
+    formLabels?: Partial<EditFormLabels>;
+    /** Starting height in px for the in-grid form, before it is measured. */
+    formHeight?: number;
+    dark?: boolean;
+    /** Lookup combos for the open row (Enterprise). */
+    rowLookups?: RowLookupMap;
+    /** A column's `renderEditor` draws its form field (Enterprise). */
+    customEditors?: boolean;
+    /** Columns that are not fields of the record (the command column). */
+    isFormColumn?: (columnId: string) => boolean;
+    /**
+     * Offer the batch Save/Cancel pair in the strip. Default true. The
+     * Enterprise grid shows it only for an explicit `mode: 'batch'` (its
+     * default batch mode saves from the command column) and passes that here.
+     */
+    batchBar?: boolean;
+}
+interface EditModes<TRow = GridRowData> {
+    /** A row mode (row / form / popup) is in force and drawn. */
+    rowModeActive: boolean;
+    /** The open row, in a row mode; null otherwise. */
+    rowSession: RowEditSession | null;
+    /** True for the row drawn as editors in `row` mode. */
+    isRowEditing: (rowKey: RowKey) => boolean;
+    /** A value drawn the way the grid draws it (renderCell → lookup → formatter → date). */
+    defaultContent: (ctx: CellSlotContext<TRow>, value: unknown) => ReactNode;
+    /** The open row's cell in `row` mode: its editor, or its value when read-only. Undefined otherwise. */
+    renderRowCell: (ctx: CellSlotContext<TRow>) => ReactNode | undefined;
+    /** A cell's PENDING value (batch), drawn; undefined when it has none. */
+    renderPending: (ctx: CellSlotContext<TRow>) => ReactNode | undefined;
+    /** The grid's `renderEditForm` slot in `form` mode; undefined otherwise. */
+    renderEditForm: ((rowKey: RowKey) => ReactNode) | undefined;
+    /** The popup form (`popup` mode, a row open), or null. Unportaled. */
+    popup: ReactNode;
+    /** The row strip (`row` mode) and the batch Save/Cancel, or null when there is nothing to show. */
+    bar: ReactNode;
+    /** What `data-row-session` on the grid's wrapper says, for the pointer lock. */
+    rowSessionAttr: 'form' | 'popup' | undefined;
+    /** "Edit row…" for the row menu, or null when no row can be opened now. */
+    editRowMenuItem: <TContext>(rowKey: RowKey) => GridMenuItem<TContext> | null;
+    /** Open a row (double-click in a row mode). False when not a row mode. */
+    openRow: (rowKey: RowKey) => boolean;
+}
+/**
+ * The columns a record's form offers, in the grid's own order.
+ *
+ * Derived from the LAYOUT rather than the raw column list, so a column the
+ * user hid stays out of the form too — offering a field nobody chose to see,
+ * and saving a value from it, is an invisible change. The grid's own columns
+ * (selection, the group column, row numbers) are never fields: with grouping
+ * shown as a column the form offered an empty, disabled "Region › Country"
+ * (pre-release review, 2026-10-16; the plain-JavaScript form already left
+ * them out).
+ */
+declare function editFormColumnIds<TRow>(controller: DataGridController<TRow> | null, isFormColumn?: (columnId: string) => boolean): string[];
+declare function useEditModes<TRow = GridRowData>({ controller, editing, mode, active, rootRef, rowHeight, formLabels, formHeight: formHeightOption, dark, rowLookups, customEditors, isFormColumn, batchBar, }: UseEditModesOptions<TRow>): EditModes<TRow>;
+
+interface GridRowEditorProps<TRow = GridRowData> {
+    controller: DataGridController<TRow>;
+    engine: EditingEngine<TRow>;
+    columnId: string;
+    /** This field's validation message, or null. */
+    message: string | null;
+    /** True while the row's save is in flight; the fields go read-only. */
+    saving: boolean;
+    /**
+     * The column's lookup items (Enterprise) — `null` while loading. Undefined
+     * draws the plain input.
+     */
+    lookupOptions?: readonly LookupItem[] | null;
+    onSave: () => void;
+    onCancel: () => void;
+}
+declare function GridRowEditor<TRow = GridRowData>({ controller, engine, columnId, message, saving, lookupOptions, onSave, onCancel, }: GridRowEditorProps<TRow>): react.JSX.Element;
+
 interface GridCellEditorProps {
     value: unknown;
     dataType: GridDataType | undefined;
@@ -2214,4 +2446,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_HEADER_MENU_LABELS, DataGrid, type DataGridProps, type DistinctEntry, type EditorRenderContext, type ExportOutcome, type FilterRenderContext, GridCellEditor, type GridCellEditorProps, GridColumnChooser, type GridColumnChooserProps, GridContextMenu, type GridContextMenuProps, GridDateEditor, type GridDateEditorProps, GridDialog, type GridDialogProps, 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, 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 RowMenuContext, type RowReorderEvent, type RowTemplateContext, SHORTCUT_COPY, SHORTCUT_CUT, SHORTCUT_PASTE, type SelectionStats, ToolbarIcon, type TooltipState, type UseDataGridOptions, type UseDataGridResult, type UseGridEditingOptions, type UseGridEditingResult, buildCellMenuItems, buildHeaderMenu, copyToClipboard, headerMenuLabels, matchOptions, measureBestFitWidth, reconcileFilterInputs, runGridExport, useAlignedGrids, useAnchoredPopup, useCellTooltip, useDataGrid, 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, 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 };