@bmsuisse/datagrid 0.30.0 → 0.31.0

package/dist/index.d.ts

@@ -863,6 +863,18 @@ interface CellEditingOptions<TRow> {
     onCellsChange: (changes: CellChange<TRow>[]) => void | Promise<void>;
     /** Disables all cell-editing interaction — e.g. while a previous gesture's `onCellsChange` is still in flight. Defaults to false. */
     disabled?: boolean;
+    /**
+     * Renders every editable cell's editor directly, all the time — no click,
+     * double-click, F2, or typed character needed to open one first. Selection
+     * (drag/shift+click/shift+arrow), copy, paste, and the fill-handle all
+     * still work exactly as they do without this flag; only the single-cell
+     * "one cell editing at a time" gate is gone, since with this on every
+     * editable cell already IS its own editor. A buffered (string/number/
+     * currency) editor still only commits on blur/Enter/Tab, same as always —
+     * this flag just means it's already open, not that it types straight
+     * through to `onCellsChange` on every keystroke. Defaults to false.
+     */
+    alwaysEdit?: boolean;
 }
 
 /** Maps each id to its position in `ids` — built once per (rowIds|columnIds) identity change, then reused for every lookup during a drag, rather than an O(n) `indexOf` per cell per mousemove. */
@@ -972,7 +984,11 @@ declare function useCellSelection({ rowIds, columnIds, onNavigateToRow }: CellSe
  * table body.
  */
 interface CellEditingCellContext<TRow> {
-    /** The one cell currently showing its editor, or `undefined` — at most one at a time, the same convention `EditingCellContext.activeRowId` uses at row granularity. */
+    /** Mirrors `CellEditingOptions.alwaysEdit` — every editable cell renders `AlwaysEditCell` instead of going through `editingCell`/`onBeginEdit` at all when this is set. */
+    alwaysEdit: boolean;
+    /** Mirrors `CellEditingOptions.disabled`. Click-to-edit mode blocks interaction by simply never opening an editor while this is set (see `onBeginEdit`'s own gate) — `AlwaysEditCell`'s editors are always open regardless, so it reads this directly to disable its rendered form control instead. */
+    disabled: boolean;
+    /** The one cell currently showing its editor, or `undefined` — at most one at a time, the same convention `EditingCellContext.activeRowId` uses at row granularity. Meaningless (always `undefined`) under `alwaysEdit`, where every editable cell already has its own editor. */
     editingCell: CellAddress | undefined;
     /** Replaces (doesn't append to) the editor's starting value when editing began by typing a printable character directly (Excel's "just start typing" gesture) rather than double-click/Enter/F2, which start from the cell's current value. `undefined` means "start from the current value." */
     initialText: string | undefined;
@@ -1015,6 +1031,8 @@ interface CellEditingCellContext<TRow> {
      */
     onCommitValue: (row: TRow, previousValue: unknown, value: unknown) => void;
     onSetError: (rowId: string, columnId: string, message: string | undefined) => void;
+    /** Commits one independently-managed cell's change directly — for `AlwaysEditCell`, which owns its own draft state locally rather than through `editingCell`/`onChangeDraft`/`onCommitEdit`'s single shared slot (every editable cell needs its own simultaneous editor under `alwaysEdit`, not just one at a time). */
+    applyChange: (change: CellChange<TRow>) => void;
     /**
      * Reads (and clears) whether `onCommitEdit`/`onCommitValue` committed
      * synchronously during the current call stack. `<DataGrid>`'s own keydown
@@ -1112,6 +1130,8 @@ declare function SelectionOverlay({ containerRef, range, fillPreviewRange, onFil
  * `null` for `number`/`currency` (pasting a blank cell over a numeric one
  * clears it, matching `NumberEditor`'s own null-for-cleared convention) —
  * `string` columns instead treat an empty string as itself a valid value.
+ * An Excel/Sheets error string (`#N/A`, `#DIV/0!`, etc.) pasted into any
+ * column but `string` is likewise skipped rather than coerced.
  */
 declare function coerceValueForColumn<TRow>(column: ColumnDef<TRow>, raw: string): {
     value: unknown;