@kanunilabs/datagrid 1.9.0 → 1.9.2

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { GridRowData, DataGridController, GridDictionary, GridDataType, LookupItem, LookupMatchMode, EditingEngineOptions, RowKey, EditingEngine, RowChange, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, GridThemeName, GridPaletteName, GridDensity, DescribeFilterOptions, CardViewOptions, StateStoringConfig, InferColumnsOptions } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDictionary, GridDataType, LookupItem, LookupMatchMode, RowKey, EditingEngineOptions, EditingEngine, RowChange, EditMode, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, GridThemeName, GridPaletteName, GridDensity, DescribeFilterOptions, CardViewOptions, StateStoringConfig, InferColumnsOptions, RowStatusSource } from '@kanunilabs/datagrid-core';
 export { CustomFilterOperator, CustomFilterOperatorId, DENSITY_ROW_HEIGHT, DataGridController, FilterNode, GRID_COLOR_SCHEMES, GridColorScheme, GridColumnDef, GridDensity, GridPaletteName, GridRowData, GridTheme, GridThemeName, RowKey, RowNode, SortDescriptor, THEME_ROW_HEIGHT, isPackagedTheme, presetRowHeight } from '@kanunilabs/datagrid-core';
 
 /** What a header menu is opened against — the React shape, verbatim. */
@@ -33,13 +33,18 @@ interface CellLookupEditorSpec {
     matchMode?: LookupMatchMode;
     allowCustom?: boolean;
     invalid?: boolean;
+    /** Take focus once connected. A cell editor does; row/form fields do not. */
+    autoFocus?: boolean;
     testId?: string;
+    columnId?: string;
     ariaLabel?: string;
     surfaceClass?: string;
     onPortalOpen?: (close: () => void) => void;
     noMatchText: string;
     onChange: (value: unknown) => void;
     onCommit: () => void;
+    /** Picking an item commits (a cell). False in row/form mode, where only Save ends it. */
+    commitOnPick?: boolean;
     onCancel: () => void;
     onTab?: (shiftKey: boolean) => void;
 }
@@ -99,6 +104,60 @@ interface CellEditorSpec {
 /** Build the editor. The caller drops the fragment into the CELL. */
 declare function buildCellEditor(spec: CellEditorSpec): DocumentFragment;
 
+interface EditFormField {
+    columnId: string;
+    label: string;
+    dataType: GridDataType | undefined;
+    editable: boolean;
+    dateFormat?: string;
+    lookup?: {
+        /** `null` = loading (dynamic list in flight). */
+        options: readonly LookupItem[] | null;
+        allowCustom?: boolean;
+        matchMode?: LookupMatchMode;
+    };
+}
+interface EditFormSpec {
+    rowKey: RowKey;
+    fields: readonly EditFormField[];
+    /** Current (pending) value per column. */
+    getValue: (columnId: string) => unknown;
+    /** Validation message per column id; only invalid columns appear. */
+    getErrors: () => Record<string, string>;
+    getSaving: () => boolean;
+    getSaveError: () => string | null;
+    isNew: boolean;
+    /** Rendered as a modal dialog rather than inline in a row. */
+    popup?: boolean;
+    /** Drawn INSIDE the grid, in the row flow (`mode: 'form'`) — drops the
+     *  floating chrome so the panel does not draw a card inside the row. */
+    inline?: boolean;
+    /** The portal surface classes (popup mode + nested editors). */
+    surfaceClass?: string;
+    /**
+     * Builds the combo box for a lookup field. Supplied by the Enterprise
+     * edition; without it a lookup field renders read-only, showing its label.
+     */
+    renderLookup?: (spec: CellLookupEditorSpec) => HTMLElement;
+    /** Called when a nested editor opens a layer on `document.body`. */
+    onPortalOpen?: (close: () => void) => void;
+    t: GridDictionary;
+    /** Reports the height the form WANTS, in px, once it is in the DOM. */
+    onNaturalHeight?: (px: number) => void;
+    onChange: (columnId: string, value: unknown) => void;
+    onSave: () => void;
+    onCancel: () => void;
+}
+interface EditFormHandle {
+    element: HTMLElement;
+    /** Re-paint errors / saving / banner in place. Never touches inputs. */
+    refresh(): void;
+    /** Swap a lookup field's control once its async list arrives. */
+    setLookupOptions(columnId: string, options: readonly LookupItem[]): void;
+    dispose(): void;
+}
+declare function buildEditForm(spec: EditFormSpec): EditFormHandle;
+
 /**
  * The Community `editing` option of `createGrid`. Passing the object turns
  * single-cell editing on; `{ enabled: false }` turns it off again. Columns
@@ -119,10 +178,31 @@ interface CellEditingOptions<TRow = GridRowData> {
     focusCellOnTab?: boolean;
     /** Tab past the end of a row wraps to the next one. Default true. */
     focusCellOnCycle?: boolean;
+    /**
+     * How edits are collected (Community since 2026-10-16). `'cell'` (default)
+     * saves every commit; `'batch'` keeps changes pending until the Save strip
+     * above the grid is pressed; `'row'` opens the whole row (double-click) with
+     * Save/Cancel, Enter/Escape; `'form'` opens a form inside the grid and
+     * `'popup'` the same form in a dialog. In the buffered modes `onSave`
+     * receives the changes and must write them to the app's data.
+     */
+    mode?: EditMode;
+    /**
+     * Rename the built-in strings for THIS grid (`save`, `cancel`,
+     * `editSaveChanges`…). Merged over the locale's dictionary.
+     */
+    formLabels?: Record<string, string>;
+    /**
+     * 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.
+     */
+    formHeight?: number;
 }
 interface CellEditingHelpers {
     /** Theme classes for portalled layers (the dialog, the date calendar). */
     surfaceClass(): string;
+    /** Where the batch / row Save-Cancel strip is mounted. */
+    barHost?: HTMLElement;
 }
 /**
  * What the Enterprise layer adds. Not part of the Community surface: the
@@ -149,6 +229,14 @@ interface CellEditingExtension<TRow = GridRowData> {
     customEditors?: boolean;
     /** Something drawn into a cell that is NOT being edited (the fill handle). */
     cellAdornment?: (ctx: CellSlotContext<TRow>) => Node | null;
+    /**
+     * A form field's lookup list (with the combo box): static lists returned,
+     * async ones delivered later through `update`. Default: the static list,
+     * shown read-only by label.
+     */
+    formLookup?: (rowKey: RowKey, columnId: string, update: (options: readonly LookupItem[]) => void) => EditFormField['lookup'];
+    /** Add buttons to the edit strip ahead of the base's (the Add button). */
+    decorateBar?: (bar: HTMLElement) => void;
 }
 interface CellEditingLayer<TRow = GridRowData> {
     engine: EditingEngine<TRow>;
@@ -172,6 +260,16 @@ interface CellEditingLayer<TRow = GridRowData> {
     trackPortal(close: () => void): void;
     /** What the Community renderer would paint for `value` in this cell. */
     defaultContent(ctx: CellSlotContext<TRow>, value: unknown): Node | string;
+    /** The `renderEditForm` slot — the in-grid form's body (`mode: 'form'`). */
+    renderEditForm(rowKey: RowKey, row: TRow | undefined): Node | string | undefined;
+    /** Open a whole row (row / form / popup). False when it cannot be. */
+    beginRowEdit(rowKey: RowKey): boolean;
+    /** Validate and save the open row; true when it saved and closed. */
+    saveRowEdit(): Promise<boolean>;
+    cancelRowEdit(): void;
+    /** Save every pending change (batch); a refusal is shown in the strip. */
+    saveChanges(): Promise<void>;
+    cancelChanges(): void;
     dispose(): void;
 }
 declare function attachCellEditing<TRow = GridRowData>(grid: Pick<GridApi<TRow>, 'controller' | 'element'>, options: CellEditingOptions<TRow>, t: GridDictionary, helpers: CellEditingHelpers, extension?: CellEditingExtension<TRow>): CellEditingLayer<TRow>;
@@ -783,18 +881,24 @@ interface CreateGridConfig<TRow = GridRowData> extends Omit<DataGridCoreConfig<T
     /** Search box debounce, ms. React's default. */
     searchDebounce?: number;
     /**
-     * Single-cell editing (Community since 2026-10-12). Off unless passed:
+     * Editing (single-cell Community since 2026-10-12; batch / row / form /
+     * popup Community since 2026-10-16, owner decision). Off unless passed:
      * `editing: {}` turns it on, `{ enabled: false }` off again. Double-click,
      * F2 or typing opens the in-cell editor (text, number, date, checkbox);
      * Enter commits and moves down, Tab / Shift+Tab commit and move to the next
-     * editable cell, Escape cancels. Each commit is written to the row and
-     * handed to `onSave`. Columns with `editable: false` stay read-only, and so
-     * do lookup and cell-formula columns, whose editors are Enterprise.
+     * editable cell, Escape cancels. In the default `mode: 'cell'` each commit
+     * is written to the row and handed to `onSave`. `mode: 'batch'` keeps
+     * changes pending until the Save strip above the grid; `'row'` opens the
+     * whole row on double-click (Save/Cancel strip, Enter/Escape); `'form'` and
+     * `'popup'` open a form inside the grid or in a dialog. In those modes
+     * `onSave` receives the changes and the app writes them to its data.
+     * Columns with `editable: false` stay read-only, and so do lookup,
+     * custom-editor and cell-formula columns, whose editors are Enterprise.
      *
-     * Batch/row/form/popup modes, validation rules, CRUD handlers, permissions,
-     * custom and lookup editors, undo/redo and range selection are Enterprise
-     * (`createEnterpriseGrid`); passed here they are ignored, and named in the
-     * console under `debugMode`.
+     * Validation rules, CRUD handlers, adding and deleting rows, per-row
+     * permissions, the command column, custom and lookup editors, undo/redo and
+     * range selection are Enterprise (`createEnterpriseGrid`); passed here they
+     * are ignored, and named in the console under `debugMode`.
      */
     editing?: CellEditingOptions<TRow>;
     /** Replace a body cell's content. `undefined` = the default painter runs. */
@@ -806,7 +910,9 @@ interface CreateGridConfig<TRow = GridRowData> extends Omit<DataGridCoreConfig<T
      */
     renderDetail?: (row: TRow) => Node | string;
     /**
-     * Body for an in-grid edit form row (`mode: 'form'`). `row` is undefined
+     * Body for an in-grid edit form row (`mode: 'form'`). With `editing` on,
+     * the grid's own form answers first; this slot covers any row it does not
+     * claim. `row` is undefined
      * for a record that does not exist yet — the form still opens, because the
      * alternative is pressing "New row" and seeing nothing happen.
      */
@@ -820,6 +926,12 @@ interface CreateGridConfig<TRow = GridRowData> extends Omit<DataGridCoreConfig<T
     enterpriseEdition?: boolean;
     /** Extra classes for a body cell (pending edit, range, fill preview…). */
     getCellClassName?: (ctx: CellSlotContext<TRow>) => string | undefined;
+    /**
+     * Where `rowStatus` reads the grid's own save status — the Enterprise
+     * wrapper's editing engine. With `editing` on here, the grid's own engine
+     * answers and this is not asked.
+     */
+    getRowStatusSource?: () => RowStatusSource | null;
     onCellPointerDown?: (ctx: CellSlotContext<TRow>, event: MouseEvent) => void;
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
@@ -902,4 +1014,4 @@ interface ConfirmDialogSpec {
 /** Open the dialog; resolves the user's answer and removes itself. */
 declare function openConfirmDialog(spec: ConfirmDialogSpec): Promise<boolean>;
 
-export { CHECKBOX_COLUMN_WIDTH, type CellEditingExtension, type CellEditingHelpers, type CellEditingLayer, type CellEditingOptions, type CellEditorSpec, type CellLookupEditorSpec, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type ConfirmDialogSpec, type CreateGridConfig, DETAIL_COLUMN_WIDTH, type DateEditorSpec, type ExportKind, type GridApi, type GridMenuItem, type GridNotesConfig, type HeaderMenuContext, type HeaderMenuDeps, type NoteCellContext, PRINT_MAX_ROWS, type PrintLayoutOptions, ROW_DRAG_MIME, ROW_NUMBER_COLUMN_WIDTH, type RowDragConfig, type RowDragPayload, type RowDropEvent, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, type VanillaColumnDef, type VanillaEditorRenderContext, type VanillaFilterRenderApi, attachCellEditing, buildCellEditor, buildDateEditor, buildHeaderMenu, createGrid, measureBestFitWidth, openConfirmDialog };
+export { CHECKBOX_COLUMN_WIDTH, type CellEditingExtension, type CellEditingHelpers, type CellEditingLayer, type CellEditingOptions, type CellEditorSpec, type CellLookupEditorSpec, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type ConfirmDialogSpec, type CreateGridConfig, DETAIL_COLUMN_WIDTH, type DateEditorSpec, type EditFormField, type EditFormHandle, type EditFormSpec, type ExportKind, type GridApi, type GridMenuItem, type GridNotesConfig, type HeaderMenuContext, type HeaderMenuDeps, type NoteCellContext, PRINT_MAX_ROWS, type PrintLayoutOptions, ROW_DRAG_MIME, ROW_NUMBER_COLUMN_WIDTH, type RowDragConfig, type RowDragPayload, type RowDropEvent, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, type VanillaColumnDef, type VanillaEditorRenderContext, type VanillaFilterRenderApi, attachCellEditing, buildCellEditor, buildDateEditor, buildEditForm, buildHeaderMenu, createGrid, measureBestFitWidth, openConfirmDialog };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { GridRowData, DataGridController, GridDictionary, GridDataType, LookupItem, LookupMatchMode, EditingEngineOptions, RowKey, EditingEngine, RowChange, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, GridThemeName, GridPaletteName, GridDensity, DescribeFilterOptions, CardViewOptions, StateStoringConfig, InferColumnsOptions } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, GridDictionary, GridDataType, LookupItem, LookupMatchMode, RowKey, EditingEngineOptions, EditingEngine, RowChange, EditMode, RowNode, GridColumnDef, DataGridCoreConfig, FilterRenderContextBase, FilterNode, GridThemeName, GridPaletteName, GridDensity, DescribeFilterOptions, CardViewOptions, StateStoringConfig, InferColumnsOptions, RowStatusSource } from '@kanunilabs/datagrid-core';
 export { CustomFilterOperator, CustomFilterOperatorId, DENSITY_ROW_HEIGHT, DataGridController, FilterNode, GRID_COLOR_SCHEMES, GridColorScheme, GridColumnDef, GridDensity, GridPaletteName, GridRowData, GridTheme, GridThemeName, RowKey, RowNode, SortDescriptor, THEME_ROW_HEIGHT, isPackagedTheme, presetRowHeight } from '@kanunilabs/datagrid-core';
 
 /** What a header menu is opened against — the React shape, verbatim. */
@@ -33,13 +33,18 @@ interface CellLookupEditorSpec {
     matchMode?: LookupMatchMode;
     allowCustom?: boolean;
     invalid?: boolean;
+    /** Take focus once connected. A cell editor does; row/form fields do not. */
+    autoFocus?: boolean;
     testId?: string;
+    columnId?: string;
     ariaLabel?: string;
     surfaceClass?: string;
     onPortalOpen?: (close: () => void) => void;
     noMatchText: string;
     onChange: (value: unknown) => void;
     onCommit: () => void;
+    /** Picking an item commits (a cell). False in row/form mode, where only Save ends it. */
+    commitOnPick?: boolean;
     onCancel: () => void;
     onTab?: (shiftKey: boolean) => void;
 }
@@ -99,6 +104,60 @@ interface CellEditorSpec {
 /** Build the editor. The caller drops the fragment into the CELL. */
 declare function buildCellEditor(spec: CellEditorSpec): DocumentFragment;
 
+interface EditFormField {
+    columnId: string;
+    label: string;
+    dataType: GridDataType | undefined;
+    editable: boolean;
+    dateFormat?: string;
+    lookup?: {
+        /** `null` = loading (dynamic list in flight). */
+        options: readonly LookupItem[] | null;
+        allowCustom?: boolean;
+        matchMode?: LookupMatchMode;
+    };
+}
+interface EditFormSpec {
+    rowKey: RowKey;
+    fields: readonly EditFormField[];
+    /** Current (pending) value per column. */
+    getValue: (columnId: string) => unknown;
+    /** Validation message per column id; only invalid columns appear. */
+    getErrors: () => Record<string, string>;
+    getSaving: () => boolean;
+    getSaveError: () => string | null;
+    isNew: boolean;
+    /** Rendered as a modal dialog rather than inline in a row. */
+    popup?: boolean;
+    /** Drawn INSIDE the grid, in the row flow (`mode: 'form'`) — drops the
+     *  floating chrome so the panel does not draw a card inside the row. */
+    inline?: boolean;
+    /** The portal surface classes (popup mode + nested editors). */
+    surfaceClass?: string;
+    /**
+     * Builds the combo box for a lookup field. Supplied by the Enterprise
+     * edition; without it a lookup field renders read-only, showing its label.
+     */
+    renderLookup?: (spec: CellLookupEditorSpec) => HTMLElement;
+    /** Called when a nested editor opens a layer on `document.body`. */
+    onPortalOpen?: (close: () => void) => void;
+    t: GridDictionary;
+    /** Reports the height the form WANTS, in px, once it is in the DOM. */
+    onNaturalHeight?: (px: number) => void;
+    onChange: (columnId: string, value: unknown) => void;
+    onSave: () => void;
+    onCancel: () => void;
+}
+interface EditFormHandle {
+    element: HTMLElement;
+    /** Re-paint errors / saving / banner in place. Never touches inputs. */
+    refresh(): void;
+    /** Swap a lookup field's control once its async list arrives. */
+    setLookupOptions(columnId: string, options: readonly LookupItem[]): void;
+    dispose(): void;
+}
+declare function buildEditForm(spec: EditFormSpec): EditFormHandle;
+
 /**
  * The Community `editing` option of `createGrid`. Passing the object turns
  * single-cell editing on; `{ enabled: false }` turns it off again. Columns
@@ -119,10 +178,31 @@ interface CellEditingOptions<TRow = GridRowData> {
     focusCellOnTab?: boolean;
     /** Tab past the end of a row wraps to the next one. Default true. */
     focusCellOnCycle?: boolean;
+    /**
+     * How edits are collected (Community since 2026-10-16). `'cell'` (default)
+     * saves every commit; `'batch'` keeps changes pending until the Save strip
+     * above the grid is pressed; `'row'` opens the whole row (double-click) with
+     * Save/Cancel, Enter/Escape; `'form'` opens a form inside the grid and
+     * `'popup'` the same form in a dialog. In the buffered modes `onSave`
+     * receives the changes and must write them to the app's data.
+     */
+    mode?: EditMode;
+    /**
+     * Rename the built-in strings for THIS grid (`save`, `cancel`,
+     * `editSaveChanges`…). Merged over the locale's dictionary.
+     */
+    formLabels?: Record<string, string>;
+    /**
+     * 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.
+     */
+    formHeight?: number;
 }
 interface CellEditingHelpers {
     /** Theme classes for portalled layers (the dialog, the date calendar). */
     surfaceClass(): string;
+    /** Where the batch / row Save-Cancel strip is mounted. */
+    barHost?: HTMLElement;
 }
 /**
  * What the Enterprise layer adds. Not part of the Community surface: the
@@ -149,6 +229,14 @@ interface CellEditingExtension<TRow = GridRowData> {
     customEditors?: boolean;
     /** Something drawn into a cell that is NOT being edited (the fill handle). */
     cellAdornment?: (ctx: CellSlotContext<TRow>) => Node | null;
+    /**
+     * A form field's lookup list (with the combo box): static lists returned,
+     * async ones delivered later through `update`. Default: the static list,
+     * shown read-only by label.
+     */
+    formLookup?: (rowKey: RowKey, columnId: string, update: (options: readonly LookupItem[]) => void) => EditFormField['lookup'];
+    /** Add buttons to the edit strip ahead of the base's (the Add button). */
+    decorateBar?: (bar: HTMLElement) => void;
 }
 interface CellEditingLayer<TRow = GridRowData> {
     engine: EditingEngine<TRow>;
@@ -172,6 +260,16 @@ interface CellEditingLayer<TRow = GridRowData> {
     trackPortal(close: () => void): void;
     /** What the Community renderer would paint for `value` in this cell. */
     defaultContent(ctx: CellSlotContext<TRow>, value: unknown): Node | string;
+    /** The `renderEditForm` slot — the in-grid form's body (`mode: 'form'`). */
+    renderEditForm(rowKey: RowKey, row: TRow | undefined): Node | string | undefined;
+    /** Open a whole row (row / form / popup). False when it cannot be. */
+    beginRowEdit(rowKey: RowKey): boolean;
+    /** Validate and save the open row; true when it saved and closed. */
+    saveRowEdit(): Promise<boolean>;
+    cancelRowEdit(): void;
+    /** Save every pending change (batch); a refusal is shown in the strip. */
+    saveChanges(): Promise<void>;
+    cancelChanges(): void;
     dispose(): void;
 }
 declare function attachCellEditing<TRow = GridRowData>(grid: Pick<GridApi<TRow>, 'controller' | 'element'>, options: CellEditingOptions<TRow>, t: GridDictionary, helpers: CellEditingHelpers, extension?: CellEditingExtension<TRow>): CellEditingLayer<TRow>;
@@ -783,18 +881,24 @@ interface CreateGridConfig<TRow = GridRowData> extends Omit<DataGridCoreConfig<T
     /** Search box debounce, ms. React's default. */
     searchDebounce?: number;
     /**
-     * Single-cell editing (Community since 2026-10-12). Off unless passed:
+     * Editing (single-cell Community since 2026-10-12; batch / row / form /
+     * popup Community since 2026-10-16, owner decision). Off unless passed:
      * `editing: {}` turns it on, `{ enabled: false }` off again. Double-click,
      * F2 or typing opens the in-cell editor (text, number, date, checkbox);
      * Enter commits and moves down, Tab / Shift+Tab commit and move to the next
-     * editable cell, Escape cancels. Each commit is written to the row and
-     * handed to `onSave`. Columns with `editable: false` stay read-only, and so
-     * do lookup and cell-formula columns, whose editors are Enterprise.
+     * editable cell, Escape cancels. In the default `mode: 'cell'` each commit
+     * is written to the row and handed to `onSave`. `mode: 'batch'` keeps
+     * changes pending until the Save strip above the grid; `'row'` opens the
+     * whole row on double-click (Save/Cancel strip, Enter/Escape); `'form'` and
+     * `'popup'` open a form inside the grid or in a dialog. In those modes
+     * `onSave` receives the changes and the app writes them to its data.
+     * Columns with `editable: false` stay read-only, and so do lookup,
+     * custom-editor and cell-formula columns, whose editors are Enterprise.
      *
-     * Batch/row/form/popup modes, validation rules, CRUD handlers, permissions,
-     * custom and lookup editors, undo/redo and range selection are Enterprise
-     * (`createEnterpriseGrid`); passed here they are ignored, and named in the
-     * console under `debugMode`.
+     * Validation rules, CRUD handlers, adding and deleting rows, per-row
+     * permissions, the command column, custom and lookup editors, undo/redo and
+     * range selection are Enterprise (`createEnterpriseGrid`); passed here they
+     * are ignored, and named in the console under `debugMode`.
      */
     editing?: CellEditingOptions<TRow>;
     /** Replace a body cell's content. `undefined` = the default painter runs. */
@@ -806,7 +910,9 @@ interface CreateGridConfig<TRow = GridRowData> extends Omit<DataGridCoreConfig<T
      */
     renderDetail?: (row: TRow) => Node | string;
     /**
-     * Body for an in-grid edit form row (`mode: 'form'`). `row` is undefined
+     * Body for an in-grid edit form row (`mode: 'form'`). With `editing` on,
+     * the grid's own form answers first; this slot covers any row it does not
+     * claim. `row` is undefined
      * for a record that does not exist yet — the form still opens, because the
      * alternative is pressing "New row" and seeing nothing happen.
      */
@@ -820,6 +926,12 @@ interface CreateGridConfig<TRow = GridRowData> extends Omit<DataGridCoreConfig<T
     enterpriseEdition?: boolean;
     /** Extra classes for a body cell (pending edit, range, fill preview…). */
     getCellClassName?: (ctx: CellSlotContext<TRow>) => string | undefined;
+    /**
+     * Where `rowStatus` reads the grid's own save status — the Enterprise
+     * wrapper's editing engine. With `editing` on here, the grid's own engine
+     * answers and this is not asked.
+     */
+    getRowStatusSource?: () => RowStatusSource | null;
     onCellPointerDown?: (ctx: CellSlotContext<TRow>, event: MouseEvent) => void;
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
@@ -902,4 +1014,4 @@ interface ConfirmDialogSpec {
 /** Open the dialog; resolves the user's answer and removes itself. */
 declare function openConfirmDialog(spec: ConfirmDialogSpec): Promise<boolean>;
 
-export { CHECKBOX_COLUMN_WIDTH, type CellEditingExtension, type CellEditingHelpers, type CellEditingLayer, type CellEditingOptions, type CellEditorSpec, type CellLookupEditorSpec, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type ConfirmDialogSpec, type CreateGridConfig, DETAIL_COLUMN_WIDTH, type DateEditorSpec, type ExportKind, type GridApi, type GridMenuItem, type GridNotesConfig, type HeaderMenuContext, type HeaderMenuDeps, type NoteCellContext, PRINT_MAX_ROWS, type PrintLayoutOptions, ROW_DRAG_MIME, ROW_NUMBER_COLUMN_WIDTH, type RowDragConfig, type RowDragPayload, type RowDropEvent, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, type VanillaColumnDef, type VanillaEditorRenderContext, type VanillaFilterRenderApi, attachCellEditing, buildCellEditor, buildDateEditor, buildHeaderMenu, createGrid, measureBestFitWidth, openConfirmDialog };
+export { CHECKBOX_COLUMN_WIDTH, type CellEditingExtension, type CellEditingHelpers, type CellEditingLayer, type CellEditingOptions, type CellEditorSpec, type CellLookupEditorSpec, type CellMenuOptions, type CellRenderContext, type CellSlotContext, type ConfirmDialogSpec, type CreateGridConfig, DETAIL_COLUMN_WIDTH, type DateEditorSpec, type EditFormField, type EditFormHandle, type EditFormSpec, type ExportKind, type GridApi, type GridMenuItem, type GridNotesConfig, type HeaderMenuContext, type HeaderMenuDeps, type NoteCellContext, PRINT_MAX_ROWS, type PrintLayoutOptions, ROW_DRAG_MIME, ROW_NUMBER_COLUMN_WIDTH, type RowDragConfig, type RowDragPayload, type RowDropEvent, type RowMenuContext, type RowReorderEvent, type RowTemplateContext, type VanillaColumnDef, type VanillaEditorRenderContext, type VanillaFilterRenderApi, attachCellEditing, buildCellEditor, buildDateEditor, buildEditForm, buildHeaderMenu, createGrid, measureBestFitWidth, openConfirmDialog };