@nubitio/crud 0.5.26 → 0.5.28

package/dist/index.cjs

@@ -2183,10 +2183,20 @@ function serializeDetailRows(rows, detailFields, detailIdField, isEditMode, adap
 function canEditFieldInline(field) {
 	return !field.isIdentity && !field.readonly && field.type !== "file" && field.visibleOnForm !== false;
 }
-function useInlineEdit({ mode, url, idField, adapter = HydraAdapter, httpClient, fields, onSaveSuccess, onSaveError }) {
+function valuesEqual$1(a, b) {
+	if (a === b) return true;
+	if (a == null && b == null) return true;
+	if (a == null || b == null) return false;
+	const numA = Number(a);
+	const numB = Number(b);
+	if (!Number.isNaN(numA) && !Number.isNaN(numB)) return numA === numB;
+	return String(a) === String(b);
+}
+function useInlineEdit({ mode, url, idField, adapter = HydraAdapter, httpClient, fields, onSaveSuccess, onSaveError, onBatchSave }) {
 	const [draftRows, setDraftRows] = (0, react$1.useState)(/* @__PURE__ */ new Map());
 	const [savingRows, setSavingRows] = (0, react$1.useState)(/* @__PURE__ */ new Set());
 	const [rowErrors, setRowErrors] = (0, react$1.useState)(/* @__PURE__ */ new Map());
+	const [activeCell, setActiveCell] = (0, react$1.useState)(null);
 	const draftRowsRef = (0, react$1.useRef)(draftRows);
 	draftRowsRef.current = draftRows;
 	const optsRef = (0, react$1.useRef)({
@@ -2196,7 +2206,8 @@ function useInlineEdit({ mode, url, idField, adapter = HydraAdapter, httpClient,
 		httpClient,
 		fields,
 		onSaveSuccess,
-		onSaveError
+		onSaveError,
+		onBatchSave
 	});
 	optsRef.current = {
 		url,
@@ -2205,9 +2216,21 @@ function useInlineEdit({ mode, url, idField, adapter = HydraAdapter, httpClient,
 		httpClient,
 		fields,
 		onSaveSuccess,
-		onSaveError
+		onSaveError,
+		onBatchSave
 	};
-	const isEditing = (0, react$1.useCallback)((key) => draftRowsRef.current.has(key), []);
+	const isEditing = (0, react$1.useCallback)((key) => draftRows.has(key), [draftRows]);
+	const isCellActive = (0, react$1.useCallback)((key, fieldName) => activeCell != null && activeCell.key === key && activeCell.fieldName === fieldName, [activeCell]);
+	const isCellDirty = (0, react$1.useCallback)((key, fieldName, original) => {
+		const draft = draftRows.get(key);
+		if (!draft) return false;
+		return !valuesEqual$1(draft[fieldName], original[fieldName]);
+	}, [draftRows]);
+	const hasDraftChanges = (0, react$1.useCallback)((key, original) => {
+		const draft = draftRows.get(key);
+		if (!draft) return false;
+		return optsRef.current.fields.some((field) => canEditFieldInline(field) && !valuesEqual$1(draft[field.name], original[field.name]));
+	}, [draftRows]);
 	const startEdit = (0, react$1.useCallback)((row) => {
 		const key = row[optsRef.current.idField];
 		setDraftRows((prev) => {
@@ -2219,7 +2242,28 @@ function useInlineEdit({ mode, url, idField, adapter = HydraAdapter, httpClient,
 			next.delete(key);
 			return next;
 		});
+		setActiveCell(null);
 	}, [mode]);
+	const startCellEdit = (0, react$1.useCallback)((row, fieldName) => {
+		const key = row[optsRef.current.idField];
+		setDraftRows((prev) => {
+			const existing = prev.get(key);
+			const withoutKey = (mode === "row" ? [] : Array.from(prev.entries())).filter(([entryKey]) => entryKey !== key);
+			return new Map([...withoutKey, [key, existing ? { ...existing } : { ...row }]]);
+		});
+		setRowErrors((prev) => {
+			const next = new Map(prev);
+			next.delete(key);
+			return next;
+		});
+		setActiveCell({
+			key,
+			fieldName
+		});
+	}, [mode]);
+	const stopCellEdit = (0, react$1.useCallback)(() => {
+		setActiveCell(null);
+	}, []);
 	const cancelEdit = (0, react$1.useCallback)((key) => {
 		setDraftRows((prev) => {
 			const next = new Map(prev);
@@ -2231,10 +2275,12 @@ function useInlineEdit({ mode, url, idField, adapter = HydraAdapter, httpClient,
 			next.delete(key);
 			return next;
 		});
+		setActiveCell((current) => current?.key === key ? null : current);
 	}, []);
 	const discardAll = (0, react$1.useCallback)(() => {
 		setDraftRows(/* @__PURE__ */ new Map());
 		setRowErrors(/* @__PURE__ */ new Map());
+		setActiveCell(null);
 	}, []);
 	const updateDraft = (0, react$1.useCallback)((key, fieldName, value) => {
 		setDraftRows((prev) => {
@@ -2301,35 +2347,102 @@ function useInlineEdit({ mode, url, idField, adapter = HydraAdapter, httpClient,
 			});
 		}
 	}, []);
+	const validateDraft = (0, react$1.useCallback)((key, draft, fs) => {
+		const errors = {};
+		fs.forEach((field) => {
+			if (!canEditFieldInline(field)) return;
+			if (field.required && (draft[field.name] == null || draft[field.name] === "")) errors[field.name] = "required";
+		});
+		if (Object.keys(errors).length === 0) return true;
+		setRowErrors((prev) => new Map(prev).set(key, errors));
+		return false;
+	}, []);
+	const doSaveBatch = (0, react$1.useCallback)(async () => {
+		const { fields: fs, onBatchSave: saveBatch, onSaveError: onErr } = optsRef.current;
+		if (!saveBatch) return false;
+		const entries = Array.from(draftRowsRef.current.entries());
+		if (entries.length === 0) return false;
+		if (!entries.every(([key, draft]) => validateDraft(key, draft, fs))) return false;
+		const keys = entries.map(([key]) => key);
+		setSavingRows((prev) => new Set([...prev, ...keys]));
+		try {
+			await saveBatch(entries.map(([, draft]) => ({ ...draft })));
+			setDraftRows(/* @__PURE__ */ new Map());
+			setRowErrors(/* @__PURE__ */ new Map());
+			return true;
+		} catch (err) {
+			keys.forEach((key) => onErr?.(key, err));
+			return false;
+		} finally {
+			setSavingRows((prev) => {
+				const next = new Set(prev);
+				keys.forEach((key) => next.delete(key));
+				return next;
+			});
+		}
+	}, [validateDraft]);
 	return {
 		draftRows,
 		savingRows,
 		rowErrors,
+		activeCell,
 		isEditing,
+		isCellActive,
+		isCellDirty,
+		hasDraftChanges,
 		startEdit,
+		startCellEdit,
+		stopCellEdit,
 		cancelEdit,
 		discardAll,
 		updateDraft,
 		saveRow: (0, react$1.useCallback)(async (key) => {
-			if (await doSaveRow(key)) optsRef.current.onSaveSuccess?.();
-		}, [doSaveRow]),
+			if (optsRef.current.onBatchSave) {
+				const ok = await doSaveBatch();
+				if (ok) optsRef.current.onSaveSuccess?.();
+				return ok;
+			}
+			const ok = await doSaveRow(key);
+			if (ok) optsRef.current.onSaveSuccess?.();
+			return ok;
+		}, [doSaveBatch, doSaveRow]),
 		saveAll: (0, react$1.useCallback)(async () => {
+			if (optsRef.current.onBatchSave) {
+				const ok = await doSaveBatch();
+				if (ok) optsRef.current.onSaveSuccess?.();
+				return ok;
+			}
 			const keys = Array.from(draftRowsRef.current.keys());
-			if ((await Promise.allSettled(keys.map((key) => doSaveRow(key)))).some((r) => r.status === "fulfilled" && r.value)) optsRef.current.onSaveSuccess?.();
-		}, [doSaveRow])
+			const anySuccess = (await Promise.allSettled(keys.map((key) => doSaveRow(key)))).some((r) => r.status === "fulfilled" && r.value);
+			if (anySuccess) optsRef.current.onSaveSuccess?.();
+			return anySuccess;
+		}, [doSaveBatch, doSaveRow])
 	};
 }
-//#endregion
-//#region packages/crud/datagrid/InlineEditCell.tsx
+function focusInlineControl(container) {
+	if (!container) return;
+	const focusable = container.querySelector("input:not([type=\"hidden\"]):not([disabled]):not([readonly]), select:not([disabled]), textarea:not([disabled]), .nb-date-picker__input:not([readonly]), .nb-dropdown__trigger:not([disabled])");
+	focusable?.focus();
+	if (focusable instanceof HTMLInputElement && focusable.type !== "checkbox") focusable.select();
+}
 /**
-* Renders a single cell as an editable control during inline row editing.
-* Uses the same FieldTypeModule.ControlRender path as the full form, but
-* with a compact common-props class so controls fit inside a table cell.
+* Renders a single cell as an editable control during inline editing.
+* Uses the same FieldTypeModule.ControlRender path as the full form, with
+* compact styling so controls fit naturally inside a table cell.
 */
-function InlineEditCell({ field, rowKey, draft, onChange, errors, disabled = false, allRemoteOptions, httpClient, t }) {
+function InlineEditCell({ field, rowKey, draft, onChange, errors, disabled = false, allRemoteOptions, httpClient, t, autoFocus = true }) {
+	const containerRef = (0, react.useRef)(null);
 	const typeModule = getFieldTypeModule(field.type);
 	const fieldError = errors?.[field.name];
 	const errorClass = fieldError ? " is-error" : "";
+	(0, react.useEffect)(() => {
+		if (!autoFocus) return;
+		focusInlineControl(containerRef.current);
+	}, [
+		autoFocus,
+		field.name,
+		rowKey
+	]);
 	const commonProps = {
 		className: `nb-inline-control${errorClass}`,
 		disabled,
@@ -2350,7 +2463,16 @@ function InlineEditCell({ field, rowKey, draft, onChange, errors, disabled = fal
 		upsertUploadedFile: () => {}
 	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		ref: containerRef,
 		className: `nb-inline-cell${errorClass ? " nb-inline-cell--error" : ""}`,
+		onKeyDown: (event) => {
+			if (event.key === "Escape") event.stopPropagation();
+		},
+		onMouseDown: (event) => {
+			if (event.target.closest(".nb-date-picker__panel, .nb-form__lookup-menu, .nb-dropdown__menu, .nb-datagrid__actions-popover")) return;
+			event.stopPropagation();
+		},
+		onClick: (event) => event.stopPropagation(),
 		children: typeModule.ControlRender({
 			field,
 			value: draft[field.name],
@@ -2479,6 +2601,25 @@ function normalizeIcon$1(icon) {
 function isDateLikeField(field) {
 	return field.type === "date" || field.type === "datetime";
 }
+function isCellEditMode(editMode) {
+	return editMode === "cell" || editMode === "batch";
+}
+function resolveInlineEditToolbar(editMode, inlineEditToolbar) {
+	if (inlineEditToolbar === false) return null;
+	const defaultShow = isCellEditMode(editMode);
+	if (inlineEditToolbar == null) return defaultShow ? {
+		save: true,
+		revert: true
+	} : null;
+	if (typeof inlineEditToolbar === "boolean") return inlineEditToolbar ? {
+		save: true,
+		revert: true
+	} : null;
+	return {
+		save: inlineEditToolbar.save !== false,
+		revert: inlineEditToolbar.revert !== false
+	};
+}
 function getToolbarKey(action, index) {
 	return action.key ?? action.text ?? String(index);
 }
@@ -2832,6 +2973,15 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 	fieldsRef.current = options.fields;
 	const loadSeqRef = (0, react.useRef)(0);
 	const loadRows = (0, react.useCallback)(async () => {
+		if (options.data) {
+			rowsRef.current = options.data;
+			setRows(options.data);
+			setTotalCount(options.data.length);
+			setGridSummary(options.gridSummary ?? null);
+			setIsGridLoading(false);
+			onContentReadyRef.current?.();
+			return options.data;
+		}
 		if (options.manualLoad) return rowsRef.current;
 		setIsGridLoading(true);
 		const seq = ++loadSeqRef.current;
@@ -2855,6 +3005,8 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 	}, [
 		filterOperators,
 		filters,
+		options.data,
+		options.gridSummary,
 		options.manualLoad,
 		options.paging,
 		page,
@@ -2898,30 +3050,58 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 		resourceStoreFactory,
 		visibleFields
 	]);
-	const canInlineEditMode = options.editMode === "row" || options.editMode === "batch";
+	const canInlineEditMode = options.editMode === "row" || options.editMode === "cell" || options.editMode === "batch";
+	const cellEditMode = isCellEditMode(options.editMode);
+	const rowInlineMode = options.editMode === "row";
+	const inlineEditToolbar = resolveInlineEditToolbar(options.editMode, options.inlineEditToolbar);
+	const showRowInlineActions = options.inlineRowActions ?? rowInlineMode;
 	const inlineEdit = useInlineEdit({
-		mode: options.editMode === "batch" ? "batch" : "row",
+		mode: cellEditMode ? "batch" : "row",
 		url: options.url,
 		idField,
 		adapter: options.adapter,
 		httpClient,
 		fields: options.fields,
 		onSaveSuccess: () => void loadRows(),
-		onSaveError: () => {}
+		onSaveError: () => {},
+		onBatchSave: options.onBatchSave
 	});
+	const dirtyRowCount = (0, react.useMemo)(() => rows.filter((row) => {
+		const key = row[idField] ?? row;
+		return inlineEdit.draftRows.has(key) && inlineEdit.hasDraftChanges(key, row);
+	}).length, [
+		rows,
+		idField,
+		inlineEdit.draftRows,
+		inlineEdit.hasDraftChanges
+	]);
+	const hasPendingInlineEdits = dirtyRowCount > 0;
+	(0, react.useEffect)(() => {
+		if (!inlineEdit.activeCell) return;
+		const handler = (event) => {
+			const target = event.target;
+			if (target.closest(".nb-datagrid__edit-cell")) return;
+			if (target.closest(".nb-date-picker__panel, .nb-form__lookup-menu, .nb-dropdown__menu, .nb-datagrid__actions-popover")) return;
+			inlineEdit.stopCellEdit();
+		};
+		document.addEventListener("mousedown", handler);
+		return () => document.removeEventListener("mousedown", handler);
+	}, [inlineEdit.activeCell, inlineEdit.stopCellEdit]);
 	const handleStateRef = (0, react.useRef)({
 		selectedKeys,
 		filters,
 		filterOperators,
 		loadRows,
-		idField
+		idField,
+		inlineEdit
 	});
 	handleStateRef.current = {
 		selectedKeys,
 		filters,
 		filterOperators,
 		loadRows,
-		idField
+		idField,
+		inlineEdit
 	};
 	(0, react.useImperativeHandle)(ref, () => ({
 		showLoading: (message) => {
@@ -2961,7 +3141,9 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 			setFilterInputs(nextFilters);
 			setFilterOperators(nextOperators);
 			setPage(0);
-		}
+		},
+		hasEditData: () => handleStateRef.current.inlineEdit.draftRows.size > 0,
+		saveChanges: () => handleStateRef.current.inlineEdit.saveAll()
 	}), [options.fields, t]);
 	const selectedRows = rows.filter((row) => selectedKeys.includes(row[idField]));
 	const selectRow = (row) => {
@@ -2975,7 +3157,7 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 	const rowEditable = (row) => options.canEditRow?.(row) !== false;
 	const rowDeletable = (row) => options.canDeleteRow?.(row) !== false;
 	const buildRowActions = (row) => [
-		...options.allowEdit && rowEditable(row) && canInlineEditMode && !inlineEdit.isEditing(row[idField]) ? [{
+		...options.allowEdit && rowEditable(row) && rowInlineMode && canInlineEditMode && !inlineEdit.isEditing(row[idField]) ? [{
 			text: t("grid.inlineEditRow"),
 			icon: "ph-pencil-simple",
 			disabled: options.editDisabled,
@@ -3005,7 +3187,7 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 		}] : []
 	];
 	const openRow = (row) => {
-		if (options.allowEdit && rowEditable(row) && canInlineEditMode) {
+		if (options.allowEdit && rowEditable(row) && rowInlineMode && canInlineEditMode) {
 			inlineEdit.startEdit(row);
 			return;
 		}
@@ -3140,7 +3322,7 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 	};
 	const totalPages = Math.max(1, Math.ceil(totalCount / pageSize));
 	const hasCheckbox = options.selectionMode === "multiple";
-	const hasBuiltInRowActions = Boolean(options.allowEdit && (canInlineEditMode || options.onEdit || options.events?.EDIT) || options.allowView && options.onView || options.allowDelete && (options.onDelete || options.events?.DELETE));
+	const hasBuiltInRowActions = Boolean(options.allowEdit && (rowInlineMode && showRowInlineActions || options.onEdit || options.events?.EDIT) || options.allowView && options.onView || options.allowDelete && (options.onDelete || options.events?.DELETE));
 	const hasRowActions = Boolean(options.mode !== "minimal" && (hasBuiltInRowActions || options.rowActions));
 	const colSpan = visibleFields.length + (hasCheckbox ? 1 : 0) + (options.detailFields ? 1 : 0) + (hasRowActions ? 1 : 0);
 	const hasDetail = Boolean(options.detailFields);
@@ -3155,15 +3337,26 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 		actionsColWidth
 	});
 	const resolvedColWidths = (0, react.useMemo)(() => {
-		if (visibleFields.length === 0) return colWidths;
-		const dataTotal = visibleFields.reduce((sum, f) => sum + getColumnWidth(f, colWidths), 0);
+		if (visibleFields.length === 0 || containerWidth <= 0) return colWidths;
+		const bases = visibleFields.map((f) => getColumnWidth(f, colWidths));
+		const dataTotal = bases.reduce((sum, width) => sum + width, 0);
 		const fixedTotal = (hasCheckbox ? CHECKBOX_COL_WIDTH : 0) + (hasDetail ? DETAIL_COL_WIDTH : 0) + (hasRowActions ? actionsColWidth : 0);
-		const extra = Math.max(0, containerWidth - dataTotal - fixedTotal);
+		const available = Math.max(0, containerWidth - fixedTotal);
+		if (dataTotal > available && available > 0) {
+			const scale = available / dataTotal;
+			const result = {};
+			visibleFields.forEach((field, index) => {
+				const floor = field.minWidth ?? MIN_COL_WIDTH;
+				result[field.name] = Math.max(floor, Math.floor(bases[index] * scale));
+			});
+			return result;
+		}
+		const extra = Math.max(0, available - dataTotal);
 		if (extra === 0 || dataTotal === 0) return colWidths;
 		let distributed = 0;
 		const result = {};
 		visibleFields.forEach((f, i) => {
-			const base = getColumnWidth(f, colWidths);
+			const base = bases[i];
 			const share = i < visibleFields.length - 1 ? Math.round(extra * (base / dataTotal)) : extra - distributed;
 			result[f.name] = base + share;
 			distributed += share;
@@ -3175,7 +3368,8 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 		hasCheckbox,
 		hasDetail,
 		hasRowActions,
-		containerWidth
+		containerWidth,
+		actionsColWidth
 	]);
 	const tableLayoutStyle = { "--nb-datagrid-layout-width": `${layoutWidth}px` };
 	const filterableFields = visibleFields.filter((field) => field.filterable);
@@ -3254,6 +3448,18 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 									children: activeFilterCount
 								})]
 							}),
+							inlineEditToolbar?.revert && hasPendingInlineEdits && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_nubitio_ui.IconButton, {
+								className: "nb-datagrid__toolbar-icon-action nb-datagrid__toolbar-icon-action--revert",
+								icon: "ph ph-arrow-counter-clockwise",
+								label: t("grid.inlineRevertChanges"),
+								onClick: () => inlineEdit.discardAll()
+							}),
+							inlineEditToolbar?.save && hasPendingInlineEdits && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_nubitio_ui.IconButton, {
+								className: "nb-datagrid__toolbar-icon-action nb-datagrid__toolbar-icon-action--save",
+								icon: "ph ph-floppy-disk",
+								label: t("grid.inlineSaveChanges"),
+								onClick: () => void inlineEdit.saveAll()
+							}),
 							toolbar.showRefresh !== false && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_nubitio_ui.IconButton, {
 								icon: "ph ph-arrow-clockwise",
 								label: t("grid.buttonRefresh"),
@@ -3261,26 +3467,13 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 							})
 						]
 					}),
-					options.editMode === "batch" && inlineEdit.draftRows.size > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "nb-datagrid__batch-bar",
+					cellEditMode && hasPendingInlineEdits && !inlineEditToolbar && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "nb-datagrid__batch-bar nb-datagrid__batch-bar--compact",
 						role: "status",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: "nb-datagrid__batch-bar-label",
-							children: t("grid.inlineUnsavedRows", { count: inlineEdit.draftRows.size })
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: "nb-datagrid__batch-bar-actions",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "nb-datagrid__batch-bar-btn nb-datagrid__batch-bar-btn--discard",
-								onClick: () => inlineEdit.discardAll(),
-								children: t("grid.inlineDiscardAll")
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "nb-datagrid__batch-bar-btn nb-datagrid__batch-bar-btn--save",
-								onClick: () => void inlineEdit.saveAll(),
-								children: t("grid.inlineSaveAll", { count: inlineEdit.draftRows.size })
-							})]
-						})]
+							children: t("grid.inlineUnsavedRows", { count: dirtyRowCount })
+						})
 					}),
 					options.aboveGrid ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "nb-datagrid__above-grid",
@@ -3576,9 +3769,11 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 											const key = row[idField] ?? rowIndex;
 											const selected = selectedKeys.includes(key);
 											const editing = inlineEdit.draftRows.has(key);
+											const rowHasChanges = editing && inlineEdit.hasDraftChanges(key, row);
 											const saving = inlineEdit.savingRows.has(key);
 											const rowDraft = inlineEdit.draftRows.get(key) ?? row;
 											const rowFieldErrors = inlineEdit.rowErrors.get(key);
+											const rowInRowEdit = rowInlineMode && editing;
 											const detailFields = typeof options.detailFields === "function" ? options.detailFields(row) : options.detailFields;
 											const detailUrl = options.detailUrl?.replace("{id}", String(key));
 											const expanded = expandedKeys.has(key);
@@ -3588,17 +3783,19 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 													"nb-datagrid__row",
 													expanded ? "nb-datagrid__row--expanded" : "",
 													selected ? "nb-datagrid__row--selected" : "",
-													editing ? "nb-datagrid__row--editing" : "",
+													rowInRowEdit ? "nb-datagrid__row--editing" : "",
+													rowHasChanges ? "nb-datagrid__row--dirty" : "",
 													saving ? "nb-datagrid__row--saving" : ""
 												].filter(Boolean).join(" "),
 												tabIndex: 0,
 												"aria-selected": selected,
 												onClick: () => {
-													if (!editing) selectRow(row);
+													if (rowInRowEdit) return;
+													selectRow(row);
 												},
 												onDoubleClick: () => {
-													if (editing) return;
-													if (options.allowEdit && rowEditable(row) && canInlineEditMode) {
+													if (rowInRowEdit || inlineEdit.activeCell) return;
+													if (options.allowEdit && rowEditable(row) && rowInlineMode && canInlineEditMode) {
 														inlineEdit.startEdit(row);
 														return;
 													}
@@ -3610,9 +3807,10 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 													if (options.allowView && options.onView) options.onView(row);
 												},
 												onKeyDown: (event) => {
-													if (editing && event.key === "Escape") inlineEdit.cancelEdit(key);
-													else if (editing && event.key === "Enter") inlineEdit.saveRow(key);
-													else if (!editing && event.key === "Enter" && options.allowEdit && canInlineEditMode && rowEditable(row)) inlineEdit.startEdit(row);
+													if (inlineEdit.activeCell && event.key === "Escape") inlineEdit.stopCellEdit();
+													else if (rowInRowEdit && event.key === "Escape") inlineEdit.cancelEdit(key);
+													else if (rowInRowEdit && event.key === "Enter" && showRowInlineActions) inlineEdit.saveRow(key);
+													else if (!editing && event.key === "Enter" && options.allowEdit && rowInlineMode && canInlineEditMode && rowEditable(row)) inlineEdit.startEdit(row);
 													else if (!editing && event.key === "Enter" && options.allowEdit && (options.onEdit || options.events?.EDIT)) if (options.onEdit) options.onEdit(row);
 													else emit(options.events.EDIT, { row });
 													else if (!editing && event.key === "Enter" && options.allowView && options.onView) options.onView(row);
@@ -3662,13 +3860,29 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 													}),
 													visibleFields.map((field, columnIndex) => {
 														const width = getColumnWidth(field, resolvedColWidths);
-														if (editing && canEditFieldInline(field)) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
+														const editable = options.allowEdit && !options.editDisabled && rowEditable(row) && canEditFieldInline(field);
+														const cellActive = inlineEdit.isCellActive(key, field.name);
+														const cellDirty = editing && inlineEdit.isCellDirty(key, field.name, row);
+														const showCellEditor = editable && (rowInRowEdit && editing || cellEditMode && cellActive);
+														const displayRow = editing ? rowDraft : row;
+														const cellClassName = [
+															showCellEditor ? "nb-datagrid__edit-cell" : "nb-datagrid__data-cell",
+															editable && canInlineEditMode ? "nb-datagrid__cell--editable" : "",
+															cellDirty ? "nb-datagrid__cell--dirty" : "",
+															cellActive ? "nb-datagrid__cell--active" : ""
+														].filter(Boolean).join(" ");
+														const beginInlineEdit = () => {
+															if (!editable) return;
+															selectRow(row);
+															if (cellEditMode) inlineEdit.startCellEdit(row, field.name);
+															else if (rowInlineMode && !editing) inlineEdit.startEdit(row);
+														};
+														if (showCellEditor) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
 															style: {
 																width,
 																textAlign: field.align
 															},
-															className: "nb-datagrid__edit-cell",
-															onClick: (e) => e.stopPropagation(),
+															className: cellClassName,
 															children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(InlineEditCell, {
 																field,
 																rowKey: key,
@@ -3678,7 +3892,8 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 																disabled: saving,
 																allRemoteOptions: filterRemoteOptions,
 																httpClient,
-																t
+																t,
+																autoFocus: true
 															})
 														}, field.name);
 														return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
@@ -3686,14 +3901,20 @@ const NativeDataGridView = (0, react.forwardRef)((options, ref) => {
 																width,
 																textAlign: field.align
 															},
-															title: getCellText(field, row, filterRemoteOptions[field.name], t("common.yes"), t("common.no")),
-															children: renderCell(field, row, rowIndex, columnIndex, filterRemoteOptions[field.name], t("common.yes"), t("common.no"))
+															className: cellClassName,
+															title: getCellText(field, displayRow, filterRemoteOptions[field.name], t("common.yes"), t("common.no")),
+															onClick: (event) => {
+																if (!editable || !canInlineEditMode) return;
+																event.stopPropagation();
+																beginInlineEdit();
+															},
+															children: renderCell(field, displayRow, rowIndex, columnIndex, filterRemoteOptions[field.name], t("common.yes"), t("common.no"))
 														}, field.name);
 													}),
 													hasRowActions && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("td", {
 														className: "nb-datagrid__actions-cell",
 														onClick: (e) => e.stopPropagation(),
-														children: editing ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+														children: rowInRowEdit && showRowInlineActions ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 															className: "nb-datagrid__inline-actions",
 															children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 																type: "button",
@@ -6978,6 +7199,8 @@ const CrudPageInner = ({ resource, onFormDataChange, initialRecordId = null, ini
 				selectionMode: hasMultipleSelection ? "multiple" : "single",
 				onSelectionChanged: handleSelectionChanged,
 				editMode: resolvedResource.editMode,
+				inlineEditToolbar: resolvedResource.inlineEditToolbar,
+				inlineRowActions: resolvedResource.inlineRowActions,
 				visibleColumns: presetState.visibleColumns,
 				beforeToolbar: renderPresetSelector,
 				aboveGrid: aboveGridContent,

package/dist/index.d.cts

@@ -23,6 +23,8 @@ interface GridHandle {
   getSelectedRows: () => DataRecord$1[];
   getFilter: () => unknown[];
   filter: (filterRule: FilterRule | null) => void;
+  hasEditData: () => boolean;
+  saveChanges: () => Promise<boolean>;
 }
 //#endregion
 //#region packages/crud/field/FieldType.d.ts
@@ -974,6 +976,13 @@ interface ResourceConfig<T extends DataRecord$1 = DataRecord$1> {
    * - `'row'` | `'cell'` | `'batch'` enable inline editing when supported.
    */
   editMode?: 'popup' | 'row' | 'cell' | 'batch';
+  /** Toolbar save/revert for inline edit. `false` hides them (use GridHandle instead). */
+  inlineEditToolbar?: boolean | {
+    save?: boolean;
+    revert?: boolean;
+  };
+  /** Per-row save/cancel in the actions column. Defaults by edit mode. */
+  inlineRowActions?: boolean;
   /** Optional layout descriptor for the dialog form: tabs or collapsible sections. */
   formLayout?: FormLayout;
   /** Named column visibility presets. When defined, a preset selector is shown in the toolbar. */
@@ -1543,6 +1552,8 @@ interface DataGridViewOptions {
   id: string;
   title: string;
   url: string;
+  /** Controlled rows. When provided, the grid renders this data instead of loading from url. */
+  data?: DataRecord$1[];
   detailUrl?: string;
   fields: Field[];
   detailFields?: Field[] | ((parentRow: DataRecord$1) => Field[]);
@@ -1581,7 +1592,20 @@ interface DataGridViewOptions {
   stateStoringEnabled?: boolean;
   toolbarVisible?: boolean;
   selectionMode?: 'single' | 'multiple';
-  inlineActions?: boolean;
+  /**
+   * Save / revert buttons shown in the toolbar when inline edits are pending.
+   * Set to `false` to hide and handle persistence via `GridHandle.saveChanges()`.
+   * Defaults to `true` for `cell` and `batch` edit modes.
+   */
+  inlineEditToolbar?: boolean | {
+    save?: boolean;
+    revert?: boolean;
+  };
+  /**
+   * Per-row save / cancel icons in the actions column while a row is being edited.
+   * Defaults to `true` for `row` mode and `false` for `cell` / `batch`.
+   */
+  inlineRowActions?: boolean;
   onBack?: () => void;
   onAdd?: () => void;
   onEdit?: (row: DataRecord$1) => void;
@@ -1591,6 +1615,8 @@ interface DataGridViewOptions {
   onRowPrepared?: (event: unknown) => void;
   onContentReady?: () => void;
   onFilterChange?: (filters: Record<string, string>) => void;
+  /** Custom batch persistence. Defaults to PATCHing each row to url/id when omitted. */
+  onBatchSave?: (rows: DataRecord$1[]) => void | Promise<void>;
   filterRow?: boolean;
   headerFilter?: boolean;
   manualLoad?: boolean;