@jielga/tmdatagrid 2.0.0-beta.0 → 2.0.0-beta.2

package/dist/index.d.ts

@@ -59,9 +59,9 @@ type TMDataGridEditActionsProps = {
   renderActions?: (args: TMDataGridEditActionsSlotArgs) => ReactNode;
 };
 /**
- * Batch mode's toolbar chrome: Save with the dirty-row count, and Discard.
+ * Draft mode's toolbar chrome: Save with the dirty-row count, and Discard.
  * Both read the edit store, so they grey out while nothing is dirty and the
- * Save spins while a submit is in flight. Works under any `editMode` - a
+ * Save spins while a submit is in flight. Works under any `editing.mode` - a
  * cellConfirm grid accumulating drafts can offer the same pair - and renders
  * nothing while editing is off.
  *
@@ -204,9 +204,9 @@ declare function optionsToComboboxData(options: ReadonlyArray<TMDataGridOption>)
  * The value shape stored in `columnFilters` for every TMDataGrid column.
  *
  * TanStack resolves `filterFn` statically per column, so the operator travels
- * inside the filter *value* instead. That keeps the whole filter model plain,
- * serialisable JSON - which is what makes it portable to a server-side
- * `manualFiltering` table (just forward `columnFilters` to the API).
+ * inside the filter *value* instead. That keeps the filter model plain,
+ * serialisable JSON, so a server-side `manualFiltering` table can forward
+ * `columnFilters` to the API unchanged.
  *
  * `value` is a string array under `isAnyOf` / `isNoneOf` (the set the cell is
  * tested against), a `[min, max]` pair under `between` (an empty string means
@@ -262,7 +262,7 @@ declare function tmDataGridFilterFn<TFeatures extends TableFeatures, TData exten
  * How commits happen - one axis, each mode a thin policy over the same
  * engine. See `editMode` on `UseTMDataGridOptions`.
  */
-type TMDataGridEditMode = "cell" | "cellConfirm" | "row" | "batch";
+type TMDataGridEditMode = "cell" | "cellConfirm" | "row" | "draft";
 /**
  * One editing row's live form. TanStack Form's `FormApi`, not a wrapper: the
  * engine is a form library, and everything mid-edit - values, dirty state,
@@ -344,6 +344,12 @@ type TMDataGridEditRowProjection = {
   /** A row-level error - a pathless `.refine()`, or a rejected commit. */
   hasRowError: boolean;
   isSubmitting: boolean;
+  /**
+   * The row as drafted - the form's `state.values`. Reference-stable while no
+   * value changes, so a cell may subscribe to it and repaint only when its
+   * row's draft actually moves.
+   */
+  values: TMDataGridRowData;
 };
 /**
  * The grid-facing index of everything mid-edit. A projection synced from the
@@ -363,15 +369,21 @@ type TMDataGridEditState = {
   } | null;
   /**
    * Rows with a live form. In cell mode at most one; in row, cellConfirm and
-   * batch, as many as the user opened - which rows are editing.
+   * draft, as many as the user opened - which rows are editing.
    */
   openRowIds: ReadonlyArray<string>;
   rows: Record<string, TMDataGridEditRowProjection>;
-  /** Phase 4 - rows being created, not yet in `data`. */
+  /**
+   * Rows being created, not yet in `data`. `confirmed` is draft mode's
+   * "entered, awaiting Save all": the entry row renders as a value row until
+   * `begin` re-opens it. Under the immediate modes a confirm commits through
+   * `onRowAdd` and the entry is dropped, so there it never turns `true`.
+   */
   newRows: ReadonlyArray<{
     tempId: string;
+    confirmed: boolean;
   }>;
-  /** Phase 4 - rows marked deleted under batch mode. */
+  /** Rows marked deleted under draft mode. */
   deletedRowIds: ReadonlyArray<string>;
 };
 type ErasedRow = Row<TMDataGridFeatures, TMDataGridRowData>;
@@ -492,24 +504,24 @@ type TMDataGridRowDeleteArgs<TData extends RowData> = {
   rowId: string;
   row: Row<TMDataGridFeatures, TData>;
 };
-/** What `submitAll` hands `onEditCommitBatch` - everything pending at once. */
-type TMDataGridEditCommitBatchArgs<TData extends RowData> = {
+/** What `submitAll` hands `onEditCommitDrafts` - everything pending at once. */
+type TMDataGridEditCommitDraftsArgs<TData extends RowData> = {
   /** Every valid dirty existing row. */
   rows: Array<TMDataGridEditCommitArgs<TData>>;
   /** Every valid new row from the entry block. */
   added: Array<TMDataGridRowAddArgs<TData>>;
-  /** Ids marked deleted while the batch accumulated. */
+  /** Ids marked deleted while the drafts accumulated. */
   deleted: Array<string>;
 };
 /**
  * The data path a column edits, or `null` for a column that has none.
  *
  * `accessorKey` is the true path and Form addresses fields by dot-path, so
- * nested rows work for free: `accessorKey: "address.city"` edits
- * `values.address.city`. A column built on `accessorFn` has no path and is
- * not editable unless `meta.edit.field` names one. TanStack's default column
- * id turns dots into underscores - which is why this starts from
- * `accessorKey`, never from `id`.
+ * nested rows need no extra handling: `accessorKey: "address.city"` edits
+ * `values.address.city`. A column built on `accessorFn` has no path and is not
+ * editable unless `meta.edit.field` names one. TanStack's default column id
+ * turns dots into underscores, which is why this starts from `accessorKey` and
+ * never from `id`.
  */
 declare function getEditFieldName(column: {
   columnDef: {
@@ -567,7 +579,7 @@ type TMDataGridEditApi = {
   deactivate: () => void;
   /** Drops every draft. */
   cancelAll: () => void;
-  /** Commits every open row - batch mode's save. `true` when all landed. */
+  /** Commits every open row - draft mode's save. `true` when all landed. */
   submitAll: () => Promise<boolean>;
   /** Writes the type's empty value into a cell and commits it - Delete. */
   clearCell: (rowId: string, columnId: string) => Promise<boolean>;
@@ -575,12 +587,12 @@ type TMDataGridEditApi = {
    * Opens a new entry row (the sticky block under the header) seeded from
    * `newRowDefaults`. Returns its temporary id - a form with no backing row
    * yet. Committing it calls `onRowAdd` (immediate modes) or joins
-   * `submitAll`'s `added` (batch).
+   * `submitAll`'s `added` (draft).
    */
   addRow: () => string;
   /**
    * Deletes a row: `onRowDelete` straight away under the immediate modes;
-   * under batch it toggles the id in `deletedRowIds` - the row renders
+   * under draft it toggles the id in `deletedRowIds` - the row renders
    * struck through until `submitAll` reports it. On an uncommitted entry
    * row it just discards the entry.
    */
@@ -701,8 +713,16 @@ type TMDataGridLabels = {
   discardNewRow: string;
   /** The lane's trash can. */
   deleteRow: string;
-  /** The lane's undo on a row marked deleted (batch). */
+  /** The lane's undo on a row marked deleted (draft). */
   restoreRow: string;
+  /** The lane's undo on a row with a dirty draft (draft) - drops it. */
+  revertRow: string;
+  /** The lane's state icon on a confirmed entry row (draft). */
+  rowStateNew: string;
+  /** The lane's state icon on a row with a dirty draft (draft). */
+  rowStateEdited: string;
+  /** The lane's state icon on a row marked deleted (draft). */
+  rowStateDeleted: string;
   cellCount: (count: number) => string;
   copy: string;
   exportCsv: string;
@@ -819,11 +839,11 @@ type GridState = TableState<TMDataGridFeatures>;
 /**
  * Persistence deliberately does not use Mantine's `useLocalStorage`.
  *
- * That hook owns a piece of state and returns `[value, setValue]`. Here the
- * table already owns the state and storage only mirrors it, so routing writes
+ * That hook holds a piece of state and returns `[value, setValue]`. Here the
+ * table already holds the state and storage only mirrors it, so routing writes
  * through the hook would keep a second copy and trigger a React state update on
  * every change, including every pointer move during a column resize. Its
- * defaults also work against this use: `getInitialValueInEffect: true` delivers
+ * defaults also conflict with this use: `getInitialValueInEffect: true` delivers
  * the stored value after mount, while `initialState` is only read on the first
  * render, and `sync: true` would let two open tabs overwrite each other's
  * column layout.
@@ -983,10 +1003,17 @@ type TMDataGridFeatureFlags = {
    * its own grouping can still say `enableGrouping: true` to override.
    */
   grouping: boolean;
-  /** Whether cells can be edited at all - `editMode` was set. */
+  /** Whether cells can be edited at all - the `editing` option was set. */
   editing: boolean;
   /** The commit policy, or `null` while editing is off. */
   editMode: TMDataGridEditMode | null;
+  /**
+   * Whether a confirmed entry row stays pinned in the sticky entry block
+   * until Save all - `editing.newRowsSticky`, draft mode only. Off by
+   * default: a confirmed row joins the scrolling flow instead, so entering
+   * many rows cannot fill the viewport with sticky chrome.
+   */
+  editNewRowsSticky: boolean;
   /** The generated row-number gutter - `enableRowNumbers`. Off by default. */
   rowNumbers: boolean;
   /**
@@ -1003,7 +1030,7 @@ type TMDataGridFeatureFlags = {
    */
   matchHighlighting: boolean;
 };
-declare function readFeatureFlags<TData extends RowData>(options: Pick<UseTMDataGridOptions<TData>, "enableSorting" | "enableColumnFilters" | "enableGlobalFilter" | "enableHiding" | "enableColumnPinning" | "enableColumnResizing" | "enableColumnOrdering" | "enableRowSelection" | "enableMultiRowSelection" | "selectionMode" | "showSelectedBackground" | "cellSelection" | "enablePagination" | "manualPagination" | "enableGrouping" | "editMode" | "enableRowNumbers" | "enableRowPinning" | "enableMatchHighlighting">): TMDataGridFeatureFlags;
+declare function readFeatureFlags<TData extends RowData>(options: Pick<UseTMDataGridOptions<TData>, "enableSorting" | "enableColumnFilters" | "enableGlobalFilter" | "enableHiding" | "enableColumnPinning" | "enableColumnResizing" | "enableColumnOrdering" | "enableRowSelection" | "enableMultiRowSelection" | "selectionMode" | "showSelectedBackground" | "cellSelection" | "enablePagination" | "manualPagination" | "enableGrouping" | "editing" | "enableRowNumbers" | "enableRowPinning" | "enableMatchHighlighting">): TMDataGridFeatureFlags;
 /**
  * What one column's header may offer.
  *
@@ -1049,8 +1076,8 @@ declare function getGridCapabilities(table: TMDataGridTable<TMDataGridRowData>,
  * Ids, because every other thing the grid does moves cells around: sorting
  * reorders rows, filtering removes them, dragging a header reorders columns. A
  * coordinate pair would silently come to mean a different cell after any of
- * them, while a pair of ids either still resolves or does not resolve at all -
- * and "does not resolve" is a state the grid can handle honestly.
+ * them, while a pair of ids either still resolves or does not resolve at all,
+ * and the grid handles "does not resolve" explicitly.
  *
  * Indices are what navigation is actually computed in, so they are resolved
  * from the ids on each keystroke and turned straight back. See resolveCellMove.
@@ -1129,11 +1156,11 @@ type ResolveRangeBoundsArgs = {
  * Turns a range into the rectangle to paint and copy, or `null` when either
  * corner no longer exists.
  *
- * A corner goes missing whenever a filter drops its row or a column is hidden,
- * and the honest answer then is that there is no rectangle - better than
- * guessing at a replacement corner and quietly copying cells the user never
- * selected. The range itself is left alone: clearing it here would throw away
- * a selection that comes straight back when the filter is lifted.
+ * A corner goes missing whenever a filter drops its row or a column is hidden.
+ * There is then no rectangle, rather than a guessed replacement corner that
+ * would copy cells the user never selected. The range itself is left alone:
+ * clearing it here would discard a selection that returns as soon as the filter
+ * is cleared.
  */
 declare function resolveRangeBounds({ range, rowIndexOf, columnIndexOf }: ResolveRangeBoundsArgs): TMDataGridRangeBounds | null;
 /** Whether a cell is inside the rectangle. */
@@ -1141,7 +1168,7 @@ declare function isWithinBounds(bounds: TMDataGridRangeBounds | null, rowIndex:
 /** How many cells the rectangle covers. `0` for no range at all. */
 declare function boundsCellCount(bounds: TMDataGridRangeBounds | null): number;
 /**
- * Which edges of the rectangle a cell sits on, for the outline.
+ * Which edges of the rectangle a cell lies on, for the outline.
  *
  * The border is drawn per cell rather than as one box over the top, because the
  * body is a scrolling CSS grid with sticky columns in it: an overlay would have
@@ -1157,14 +1184,14 @@ declare function boundsEdges(bounds: TMDataGridRangeBounds | null, rowIndex: num
 //#endregion
 //#region .types-tmp/useTMDataGrid.d.ts
 /**
- * Per-column configuration the TMDataGrid chrome reads.
+ * Per-column configuration the grid's own components read.
  *
- * A stage that owns behaviour gets a namespace - `filter` and `edit`, each
+ * The filter and edit stages each get a namespace, `filter` and `edit`,
  * mirroring the feature's runtime API. What the column *is* stays flat:
  * `label`, `type`, `options`, `align`, `flex`, `autoSize`, `enableOrdering`.
- * `type` and `options` in particular are shared ground - one declaration of
- * each feeds the filter panel and the cell editor alike, which is why they sit
- * outside both namespaces.
+ * `type` and `options` are read by both stages, so one declaration of each
+ * feeds the filter panel and the cell editor, which is why they sit outside
+ * both namespaces.
  */
 type TMDataGridColumnMeta = {
   /** Name shown in menus and the column manager. Falls back to a string header. */
@@ -1515,7 +1542,7 @@ type TMDataGridApi<TData extends RowData> = {
    * The edit engine - open forms, dirty/error projections, and the verbs
    * (`begin`, `commit`, `cancel`, `submitAll`). `edit.getForm(rowId)` hands
    * out the same TanStack Form the inline editors write through, so a drawer
-   * or detail panel can share a row's draft. Inert until `editMode` is set.
+   * or detail panel can share a row's draft. Inert until `editing` is set.
    */
   edit: TMDataGridEditApi;
   /** Table-level feature switches, re-read from options on every render. */
@@ -1558,19 +1585,13 @@ type TMDataGridApi<TData extends RowData> = {
    */
   scrollToRow: (args: TMDataGridScrollToRowArgs) => boolean;
   /**
-   * @internal Wiring for `TMDataGrid.Table`, which owns the virtualizer and
-   * fills this in. Not part of the supported surface.
+   * @internal Wiring for `TMDataGrid.Table`, which holds the virtualizer and
+   * fills this in. Not part of the public API.
    */
   scrollerRef: MutableRefObject<TMDataGridScroller>;
 };
-/** The editing callbacks every mode shares. See {@link TMDataGridEditingOptions}. */
+/** The editing members every mode shares. See {@link TMDataGridEditingOptions}. */
 type TMDataGridEditingCallbacks<TData extends RowData> = {
-  /**
-   * `getRowId` stops being optional once editing is on: the forms are keyed
-   * by row id and live outside the DOM, and the index fallback points at a
-   * different record after any sort.
-   */
-  getRowId: NonNullable<TableOptions<TMDataGridFeatures, TData>["getRowId"]>;
   /**
    * Form-level validators for the whole editing row - where cross-field
    * rules live. TanStack Form's own vocabulary, Standard Schema included:
@@ -1596,10 +1617,10 @@ type TMDataGridEditingCallbacks<TData extends RowData> = {
    * draft visible with a busy marker - and a rejection keeps the form open
    * with the error on the row.
    *
-   * `changes` is the per-field diff (one entry in cell mode) for consumers
-   * who PATCH; `value` is the whole edited row for those who save records.
+   * `changes` is the per-field diff (one entry in cell mode), for a PATCH.
+   * `value` is the entire edited row, for saving a record.
    */
-  onEditCommit?: (args: TMDataGridEditCommitArgs<TData>) => void | Promise<void>;
+  onCommit?: (args: TMDataGridEditCommitArgs<TData>) => void | Promise<void>;
   /**
    * Seed values for `edit.addRow()` - the entry row's starting point. A
    * function is called per added row (fresh timestamps, empty arrays).
@@ -1607,34 +1628,37 @@ type TMDataGridEditingCallbacks<TData extends RowData> = {
   newRowDefaults?: TData | (() => TData);
   /**
    * Called when an entry row commits: `Enter` or the lane's ✓ under the
-   * immediate modes, `submitAll` under batch. Create the record and let it
+   * immediate modes, `submitAll` under draft. Create the record and let it
    * arrive back through `data`; the engine's `tempId` never leaves the grid.
    */
   onRowAdd?: (args: TMDataGridRowAddArgs<TData>) => void | Promise<void>;
   /**
    * Called by `edit.deleteRow` under the immediate modes - confirmation, if
-   * any, belongs in here. Under batch, deletions accumulate in
+   * any, belongs in here. Under draft, deletions accumulate in
    * `edit.state.deletedRowIds` instead and are reported by `submitAll`.
    * Setting this also puts the trash can in the edit lane.
    */
   onRowDelete?: (args: TMDataGridRowDeleteArgs<TData>) => void | Promise<void>;
 };
 /**
- * The editing options travel together, and the type states it: without
- * `editMode` none of them has anything to act on, so passing one is a
- * compile error rather than a dead option; with it, `getRowId` becomes
- * required; and `onEditCommitBatch` exists only under `"batch"` - the one
- * mode whose `submitAll` calls it.
- *
- * `editMode` itself turns cell editing on and picks how commits happen. Off
- * by default.
+ * The `editing` option: one object that turns editing on and holds
+ * everything about it. `mode` picks what counts as a commit and which
+ * controls trigger it; the other members act within that mode.
  *
  * | Mode | Commit | Cancel |
  * | ---- | ------ | ------ |
  * | `"cell"` | Enter, Tab, blur - Sheets | Escape |
  * | `"cellConfirm"` | ✓ or Enter only; blur keeps the draft | ✕ or Escape |
  * | `"row"` | Save in the edit lane, or Ctrl+Enter | Cancel, or Escape |
- * | `"batch"` | `edit.submitAll()` | `edit.cancelAll()` |
+ * | `"draft"` | `edit.submitAll()` | `edit.cancelAll()` |
+ *
+ * Setting `editing` makes `getRowId` required - drafts are keyed by row id,
+ * and the index fallback would name a different record after any sort - and
+ * `onCommitDrafts` exists only under `mode: "draft"`, the one mode whose
+ * `submitAll` calls it.
+ *
+ * The object may be written inline: the callbacks are read through a ref
+ * every render, so its identity does not matter.
  *
  * One TanStack Form per editing row; drafts survive scrolling because the
  * forms live outside the DOM, keyed by row id. Which columns edit, and with
@@ -1642,30 +1666,42 @@ type TMDataGridEditingCallbacks<TData extends RowData> = {
  * built-in editor, and `enabled`, `field`, `editor`, `validate` and `mapValue`
  * override the rest.
  */
-type TMDataGridEditingOptions<TData extends RowData> = (TMDataGridEditingCallbacks<TData> & {
-  editMode: "batch";
+type TMDataGridEditingOptions<TData extends RowData> = TMDataGridEditingCallbacks<TData> & ({
+  mode: "draft";
   /**
-   * Batch mode's save, called once by `edit.submitAll()` with every
+   * Draft mode's save, called once by `edit.submitAll()` with every
    * valid dirty row. Without it, `submitAll` falls back to the per-row
-   * {@link TMDataGridEditingCallbacks.onEditCommit} loop. Rows failing
+   * {@link TMDataGridEditingCallbacks.onCommit} loop. Rows failing
    * validation stay open either way; a rejection keeps every draft.
    */
-  onEditCommitBatch?: (args: TMDataGridEditCommitBatchArgs<TData>) => void | Promise<void>;
-}) | (TMDataGridEditingCallbacks<TData> & {
-  editMode: Exclude<TMDataGridEditMode, "batch">;
-  /** Only `"batch"`'s `submitAll` ever calls it - see the other branch. */
-  onEditCommitBatch?: never;
-}) | {
-  editMode?: never;
-  rowValidators?: never;
-  isRowEditable?: never;
-  onEditCommit?: never;
-  onEditCommitBatch?: never;
-  newRowDefaults?: never;
-  onRowAdd?: never;
-  onRowDelete?: never;
-};
-type UseTMDataGridOptions<TData extends RowData> = Omit<TableOptions<TMDataGridFeatures, TData>, "features"> & TMDataGridEditingOptions<TData> & {
+  onCommitDrafts?: (args: TMDataGridEditCommitDraftsArgs<TData>) => void | Promise<void>;
+  /**
+   * Keep confirmed entry rows pinned in the sticky entry block until
+   * Save all. Off by default: a confirmed row joins the scrolling
+   * flow above the body rows instead - the block a row is *typed*
+   * into is always sticky, but entered rows scroll, so entering many
+   * cannot fill the viewport with sticky chrome.
+   */
+  newRowsSticky?: boolean;
+} | {
+  mode: Exclude<TMDataGridEditMode, "draft">;
+  /** Only `"draft"`'s `submitAll` ever calls it - see the other branch. */
+  onCommitDrafts?: never;
+  /** Confirmed entry rows exist only under `"draft"` - see there. */
+  newRowsSticky?: never;
+});
+type UseTMDataGridOptions<TData extends RowData> = Omit<TableOptions<TMDataGridFeatures, TData>, "features"> & ({
+  editing?: undefined;
+} | {
+  /** Turns editing on. See {@link TMDataGridEditingOptions}. */
+  editing: TMDataGridEditingOptions<TData>;
+  /**
+   * Required once `editing` is set: the forms are keyed by row id and
+   * live outside the DOM, and the index fallback points at a different
+   * record after any sort.
+   */
+  getRowId: NonNullable<TableOptions<TMDataGridFeatures, TData>["getRowId"]>;
+}) & {
   /**
    * Restore and persist table state across mounts. Two keys, because the two
    * kinds of state have different lifetimes - see {@link TMDataGridPersistence}.
@@ -1885,9 +1921,9 @@ type UseTMDataGridOptions<TData extends RowData> = Omit<TableOptions<TMDataGridF
    * Defaults to 160.
    *
    * An estimate, not a height: every mounted row is measured, so the real one
-   * takes over as soon as the panel is on screen. It keeps the scrollbar honest
-   * for panels that open off screen (restored `expanded` state, say), and being
-   * roughly right is enough.
+   * takes over as soon as the panel is on screen. It keeps the scrollbar
+   * accurate for panels that open off screen, such as restored `expanded`
+   * state. An approximate value is enough.
    */
   renderDetailsEstHeight?: number;
   /**
@@ -1911,7 +1947,7 @@ type UseTMDataGridOptions<TData extends RowData> = Omit<TableOptions<TMDataGridF
  * flag on, so `<TMDataGrid.Footer />` renders its pager without further
  * options.
  */
-declare function useTMDataGrid<TData extends RowData>({ persist, labels: labelsOverride, enableColumnOrdering, enablePagination, enableRowNumbers, selectionMode, showSelectedBackground, defaultHighlightedRowId, onHighlightedRowChange, cellSelection, onFocusedCellChange, editMode, rowValidators, isRowEditable, onEditCommit, onEditCommitBatch, newRowDefaults, onRowAdd, onRowDelete, renderDetails, renderDetailsEstHeight, overscan, ...options }: UseTMDataGridOptions<TData>): TMDataGridApi<TData>;
+declare function useTMDataGrid<TData extends RowData>({ persist, labels: labelsOverride, enableColumnOrdering, enablePagination, enableRowNumbers, selectionMode, showSelectedBackground, defaultHighlightedRowId, onHighlightedRowChange, cellSelection, onFocusedCellChange, editing, renderDetails, renderDetailsEstHeight, overscan, ...options }: UseTMDataGridOptions<TData>): TMDataGridApi<TData>;
 /**
  * Opens the filter panel for a column, seeding an empty filter row when the
  * column has none yet - mirrors "Filter" in the column header menu.
@@ -2213,9 +2249,9 @@ declare function toClipboardText(matrix: TMDataGridCellMatrix): string;
  * | UTF-8 BOM | without it Excel reads the file as ANSI, and å ä ö arrive broken |
  * | CRLF line endings | what Excel writes, and what its importer is happiest with |
  *
- * The `sep=` line is Excel's alone; other readers show it as a first row. That
- * is the trade this makes - the file is for Excel, and "it just opens" is worth
- * more than being a well-behaved CSV nobody was going to feed to a parser.
+ * The `sep=` line is Excel's alone; other readers show it as a first row. This
+ * export targets Excel, so opening correctly there takes priority over strict
+ * CSV.
  */
 declare function toExcelCsv(matrix: TMDataGridCellMatrix, { separator }: {
   separator: string;
@@ -2226,7 +2262,7 @@ declare function toExcelCsv(matrix: TMDataGridCellMatrix, { separator }: {
  * The async clipboard API only resolves for a document that has the focus and a
  * user gesture behind it - both true when this runs off Ctrl+C or a menu item.
  * It is still allowed to reject (a permissions policy, a page that lost focus
- * mid-copy), so the result is a boolean rather than a promise nobody checks.
+ * mid-copy), so the result is a boolean the caller can act on.
  */
 declare function writeClipboardText(text: string): Promise<boolean>;
 /**
@@ -2473,9 +2509,9 @@ type TMDataGridTableProps<TData extends RowData> = {
    */
   reachEndThreshold?: number;
   /**
-   * Accessible name for the grid - what a screen reader announces on entry,
-   * and what `getByRole("grid", { name })` matches. Worth setting on any page
-   * holding more than one grid; without it they are all just "grid".
+   * Accessible name for the grid: what a screen reader announces on entry, and
+   * what `getByRole("grid", { name })` matches. Set it on any page holding more
+   * than one grid; without it they are all announced as "grid".
    */
   "aria-label"?: string;
   /** As {@link "aria-label"}, pointing at an element that already names it. */
@@ -2483,9 +2519,9 @@ type TMDataGridTableProps<TData extends RowData> = {
 };
 /**
  * The scrollable grid surface. Always virtualized: only the rows inside the
- * viewport (plus overscan) are mounted - which is what makes the default
- * no-pagination mode viable at any row count. Pagination is opt-in via
- * `enablePagination` (or implied by `manualPagination`).
+ * viewport (plus overscan) are mounted, which is what makes the default
+ * no-pagination mode work at any row count. Pagination is opt in through
+ * `enablePagination`, or implied by `manualPagination`.
  */
 declare function TMDataGridTable$1<TData extends RowData = TMDataGridRowData>({ onRowClick, onCellClick, onCellDoubleClick, onCellContextMenu, rowClassName, rowStyle, striped, onScrollToTop, onScrollToBottom, onScrollToLeft, onScrollToRight, renderEmptyState, renderRowContextMenu, renderColumnMenuItems, rowContextMenuProps, cellExport, onReachEnd, reachEndThreshold, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy }: TMDataGridTableProps<TData>): import("react").JSX.Element;
 //#endregion
@@ -2775,6 +2811,16 @@ declare function isColumnEditableForRow(column: ColumnLike, row: Row<TMDataGridF
  * chevron, and wants the padding.
  */
 declare function isControlColumn(columnId: string): boolean;
+/**
+ * Whether the grid generated this column rather than the consumer declaring it
+ * - the four control lanes plus the tree column.
+ *
+ * These hold the grid's own chrome, and they keep the edges of the row: the
+ * generated left lanes before every consumer column, the edit lane after all of
+ * them. `isControlColumn` answers a narrower question about layout, and leaves
+ * the tree column out because it is padded like a data column.
+ */
+declare function isGeneratedColumn(columnId: string): boolean;
 /**
  * Whether a column may be moved. Ordering is the one column feature TanStack
  * has no column option for, so the switch lives in `meta.enableOrdering`.
@@ -2829,7 +2875,9 @@ declare function aggregateColumn<TData extends RowData>({ table, columnId, fn }:
  *
  * Mounted cells only: under virtualization the unmounted rows do not exist to
  * be measured, so this reads the visible window plus overscan - the same
- * trade AG Grid's autosize makes by default.
+ * trade AG Grid's autosize makes by default. With no rows mounted at all the
+ * header is the only thing left to measure, which is a width that fits the
+ * title and nothing else - see `hasMountedCells`.
  */
 declare function measureColumnContentWidth({ container, columnId }: {
   /** The grid's scroll container - anything enclosing the column's cells. */
@@ -2928,6 +2976,20 @@ type MoveColumnArgs = {
  * updates that array as well.
  */
 declare function moveColumn({ table, columnId, targetId, side }: MoveColumnArgs): void;
+/**
+ * Puts the generated lanes back on the outside of both pinned lanes: the ones
+ * on the left before every consumer column, the edit lane after all of them.
+ *
+ * `column.pin("right")` appends, so pinning a column right would otherwise drop
+ * it outside the edit lane, so the row's Save and Delete would no longer be
+ * last in the row. Pinning left appends too, which is already correct there,
+ * but the same pass keeps both lanes in place whatever a consumer writes into
+ * `columnPinning` directly.
+ *
+ * Relative order is preserved inside each part, so a user's own arrangement of
+ * the pinned columns survives.
+ */
+declare function keepGeneratedColumnsOutermost(pinning: ColumnPinningState): ColumnPinningState;
 type ColumnStepArgs = {
   table: GridTable;
   columnId: string;
@@ -2998,9 +3060,9 @@ type ResolveRowSelectionClickArgs<TData extends RowData> = {
   /**
    * Whether this gesture is allowed to clear rows it did not touch.
    *
-   * `true` for a bare row click, where replacing is the whole point. `false` for
-   * a checkbox, which is only ever additive - ticking one box has never cleared
-   * the others, and shift-clicking one adds the range rather than becoming it.
+   * `true` for a bare row click, which replaces the selection. `false` for a
+   * checkbox, which is only ever additive: ticking one box does not clear the
+   * others, and shift-clicking one adds the range rather than replacing it.
    */
   canReplaceSelection: boolean;
 };
@@ -3044,4 +3106,4 @@ declare function getSelectableRowIds<TData extends RowData>(row: Row<TMDataGridF
  */
 declare function resolveRowSelectionClick<TData extends RowData>({ rows, rowId, anchorRowId, modifiers, selection, canReplaceSelection }: ResolveRowSelectionClickArgs<TData>): ResolvedRowSelection;
 //#endregion
-export { type BuildCellMatrixArgs, type ColumnStepArgs, DATA_STATE_SLICES, DEFAULT_CELL_EXPORT_OPTIONS, DEFAULT_TMDATAGRID_SIZE, DETAILS_COLUMN_ID, DgAutocompleteFilter, DgDateRangeFilter, DgRangeSliderFilter, DgTriStateFilter, EDIT_COLUMN_ID, FILTER_OPERATOR_LABELS, GROUP_COLUMN_ID, type MoveColumnArgs, PERSIST_PAYLOAD_VERSION, ROW_NUMBER_COLUMN_ID, type ResolveCellMoveArgs, type ResolveRangeBoundsArgs, type ResolveRowSelectionClickArgs, type ResolvedRowSelection, SELECT_COLUMN_ID, SETTINGS_STATE_SLICES, SIZE_CONTROL_SIZE, SIZE_ROW_HEIGHT, TMDATAGRID_LABELS_EN, TMDATAGRID_LABELS_SV, TMDataGrid, type TMDataGridAggregationName, type TMDataGridApi, TMDataGridBooleanEditor, type TMDataGridCapabilities, type TMDataGridCellCoords, type TMDataGridCellEventArgs, type TMDataGridCellExportOptions, type TMDataGridCellMatrix, type TMDataGridCellNav, type TMDataGridCellPosition, type TMDataGridCellRange, type TMDataGridCellSelectionMode, type TMDataGridColumnCapabilities, type TMDataGridColumnEditOptions, type TMDataGridColumnFilterOptions, type TMDataGridColumnLayout, type TMDataGridColumnMenuItemsArgs, type TMDataGridColumnMenuItemsRenderer, type TMDataGridColumnMeta, type TMDataGridColumnRegion, type TMDataGridColumnType, type TMDataGridContextValue, type TMDataGridDataSlice, TMDataGridDateEditor, type TMDataGridDetailsArgs, type TMDataGridDetailsRenderer, type TMDataGridDropSide, TMDataGridEditActions, type TMDataGridEditActionsActions, type TMDataGridEditActionsControls, type TMDataGridEditActionsProps, type TMDataGridEditActionsSlotArgs, type TMDataGridEditActionsState, type TMDataGridEditApi, type TMDataGridEditChange, type TMDataGridEditCommitArgs, type TMDataGridEditCommitBatchArgs, type TMDataGridEditField, type TMDataGridEditMode, type TMDataGridEditRowProjection, type TMDataGridEditState, type TMDataGridEditValueMap, type TMDataGridEditValueMapArgs, type TMDataGridEditingOptions, type TMDataGridEditorArgs, type TMDataGridEditorComponent, type TMDataGridExpandAllArgs, type TMDataGridExpandTarget, type TMDataGridFeatureFlags, type TMDataGridFeatures, type TMDataGridFieldValidate, type TMDataGridFilterControlArgs, type TMDataGridFilterControlComponent, type TMDataGridFilterOperator, TMDataGridFilterPills, type TMDataGridFilterPillsProps, type TMDataGridFilterValue, TMDataGridFilterValueInput, type TMDataGridFooterProps, type TMDataGridLabels, type TMDataGridLabelsOverride, TMDataGridMultiSelectEditor, TMDataGridNumberEditor, type TMDataGridOption, type TMDataGridOptionsArgs, type TMDataGridOptionsSource, type TMDataGridPaginationActions, type TMDataGridPaginationApi, type TMDataGridPaginationControls, type TMDataGridPaginationSlotArgs, type TMDataGridPaginationState, type TMDataGridPersistKey, type TMDataGridPersistence, type TMDataGridProps, type TMDataGridQuickSearchMode, type TMDataGridRangeBounds, type TMDataGridRowAddArgs, type TMDataGridRowClickModifiers, type TMDataGridRowContextMenuArgs, type TMDataGridRowContextMenuRenderer, type TMDataGridRowData, type TMDataGridRowDeleteArgs, type TMDataGridRowEditForm, type TMDataGridRowStyle, type TMDataGridRowValidators, type TMDataGridScrollAlign, type TMDataGridScrollToRowArgs, TMDataGridSearch, type TMDataGridSearchProps, TMDataGridSelectEditor, type TMDataGridSelectionMode, type TMDataGridSettingsSlice, type TMDataGridSize, type TMDataGridStorageMode, TMDataGridStringEditor, type TMDataGridTable, type TMDataGridTableMeta, type TMDataGridTableProps, type TMDataGridUiActions, type TMDataGridUiState, type TMDataGridUiStore, type UseTMDataGridOptions, aggregateColumn, areAllRowsExpanded, autosizeColumn, boundsCellCount, boundsEdges, buildCellMatrix, buildGridCellMatrix, clearedValueForType, createTMDataGridColumnHelper, downloadTextFile, emptyValueForOperator, exportGridToCsv, formatExportValue, formatFilterLabel, formatGroupValue, fuzzyGlobalFilterFn, getColumnCapabilities, getColumnDefaultOperator, getColumnFilterControl, getColumnLabel, getColumnRegion, getColumnType, getDefaultOperator, getDisplayedRows, getEditFieldName, getGridCapabilities, getGroupDataRows, getOperatorsForType, getSelectableRowIds, getStepTargetColumn, getTMDataGridPaginationApi, isColumnEditableForRow, isColumnReorderable, isControlColumn, isFilterActive, isPagingActive, isSameCell, isWithinBounds, measureColumnContentWidth, mergeLabels, moveColumn, moveColumnByStep, normalizeFieldValidate, openColumnFilter, operatorNeedsValue, operatorTakesArrayValue, operatorTakesRangeValue, optionsToComboboxData, readFeatureFlags, resolveCellMove, resolveColumnOptions, resolveExpandAll, resolveRangeBounds, resolveRowSelectionClick, tmDataGridFeatures, toClipboardText, toExcelCsv, useCellControlTabIndex, useTMDataGrid, useTMDataGridContext, writeClipboardText };
+export { type BuildCellMatrixArgs, type ColumnStepArgs, DATA_STATE_SLICES, DEFAULT_CELL_EXPORT_OPTIONS, DEFAULT_TMDATAGRID_SIZE, DETAILS_COLUMN_ID, DgAutocompleteFilter, DgDateRangeFilter, DgRangeSliderFilter, DgTriStateFilter, EDIT_COLUMN_ID, FILTER_OPERATOR_LABELS, GROUP_COLUMN_ID, type MoveColumnArgs, PERSIST_PAYLOAD_VERSION, ROW_NUMBER_COLUMN_ID, type ResolveCellMoveArgs, type ResolveRangeBoundsArgs, type ResolveRowSelectionClickArgs, type ResolvedRowSelection, SELECT_COLUMN_ID, SETTINGS_STATE_SLICES, SIZE_CONTROL_SIZE, SIZE_ROW_HEIGHT, TMDATAGRID_LABELS_EN, TMDATAGRID_LABELS_SV, TMDataGrid, type TMDataGridAggregationName, type TMDataGridApi, TMDataGridBooleanEditor, type TMDataGridCapabilities, type TMDataGridCellCoords, type TMDataGridCellEventArgs, type TMDataGridCellExportOptions, type TMDataGridCellMatrix, type TMDataGridCellNav, type TMDataGridCellPosition, type TMDataGridCellRange, type TMDataGridCellSelectionMode, type TMDataGridColumnCapabilities, type TMDataGridColumnEditOptions, type TMDataGridColumnFilterOptions, type TMDataGridColumnLayout, type TMDataGridColumnMenuItemsArgs, type TMDataGridColumnMenuItemsRenderer, type TMDataGridColumnMeta, type TMDataGridColumnRegion, type TMDataGridColumnType, type TMDataGridContextValue, type TMDataGridDataSlice, TMDataGridDateEditor, type TMDataGridDetailsArgs, type TMDataGridDetailsRenderer, type TMDataGridDropSide, TMDataGridEditActions, type TMDataGridEditActionsActions, type TMDataGridEditActionsControls, type TMDataGridEditActionsProps, type TMDataGridEditActionsSlotArgs, type TMDataGridEditActionsState, type TMDataGridEditApi, type TMDataGridEditChange, type TMDataGridEditCommitArgs, type TMDataGridEditCommitDraftsArgs, type TMDataGridEditField, type TMDataGridEditMode, type TMDataGridEditRowProjection, type TMDataGridEditState, type TMDataGridEditValueMap, type TMDataGridEditValueMapArgs, type TMDataGridEditingOptions, type TMDataGridEditorArgs, type TMDataGridEditorComponent, type TMDataGridExpandAllArgs, type TMDataGridExpandTarget, type TMDataGridFeatureFlags, type TMDataGridFeatures, type TMDataGridFieldValidate, type TMDataGridFilterControlArgs, type TMDataGridFilterControlComponent, type TMDataGridFilterOperator, TMDataGridFilterPills, type TMDataGridFilterPillsProps, type TMDataGridFilterValue, TMDataGridFilterValueInput, type TMDataGridFooterProps, type TMDataGridLabels, type TMDataGridLabelsOverride, TMDataGridMultiSelectEditor, TMDataGridNumberEditor, type TMDataGridOption, type TMDataGridOptionsArgs, type TMDataGridOptionsSource, type TMDataGridPaginationActions, type TMDataGridPaginationApi, type TMDataGridPaginationControls, type TMDataGridPaginationSlotArgs, type TMDataGridPaginationState, type TMDataGridPersistKey, type TMDataGridPersistence, type TMDataGridProps, type TMDataGridQuickSearchMode, type TMDataGridRangeBounds, type TMDataGridRowAddArgs, type TMDataGridRowClickModifiers, type TMDataGridRowContextMenuArgs, type TMDataGridRowContextMenuRenderer, type TMDataGridRowData, type TMDataGridRowDeleteArgs, type TMDataGridRowEditForm, type TMDataGridRowStyle, type TMDataGridRowValidators, type TMDataGridScrollAlign, type TMDataGridScrollToRowArgs, TMDataGridSearch, type TMDataGridSearchProps, TMDataGridSelectEditor, type TMDataGridSelectionMode, type TMDataGridSettingsSlice, type TMDataGridSize, type TMDataGridStorageMode, TMDataGridStringEditor, type TMDataGridTable, type TMDataGridTableMeta, type TMDataGridTableProps, type TMDataGridUiActions, type TMDataGridUiState, type TMDataGridUiStore, type UseTMDataGridOptions, aggregateColumn, areAllRowsExpanded, autosizeColumn, boundsCellCount, boundsEdges, buildCellMatrix, buildGridCellMatrix, clearedValueForType, createTMDataGridColumnHelper, downloadTextFile, emptyValueForOperator, exportGridToCsv, formatExportValue, formatFilterLabel, formatGroupValue, fuzzyGlobalFilterFn, getColumnCapabilities, getColumnDefaultOperator, getColumnFilterControl, getColumnLabel, getColumnRegion, getColumnType, getDefaultOperator, getDisplayedRows, getEditFieldName, getGridCapabilities, getGroupDataRows, getOperatorsForType, getSelectableRowIds, getStepTargetColumn, getTMDataGridPaginationApi, isColumnEditableForRow, isColumnReorderable, isControlColumn, isFilterActive, isGeneratedColumn, isPagingActive, isSameCell, isWithinBounds, keepGeneratedColumnsOutermost, measureColumnContentWidth, mergeLabels, moveColumn, moveColumnByStep, normalizeFieldValidate, openColumnFilter, operatorNeedsValue, operatorTakesArrayValue, operatorTakesRangeValue, optionsToComboboxData, readFeatureFlags, resolveCellMove, resolveColumnOptions, resolveExpandAll, resolveRangeBounds, resolveRowSelectionClick, tmDataGridFeatures, toClipboardText, toExcelCsv, useCellControlTabIndex, useTMDataGrid, useTMDataGridContext, writeClipboardText };