@jielga/tmdatagrid 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -1,36 +1,25 @@
-import * as react from 'react';
-import { ReactNode, CSSProperties } from 'react';
-import { TableFeatures, RowData, Row, TableState, Column, Table, TableOptions, ColumnPinningState } from '@tanstack/react-table';
-import { MantineSize } from '@mantine/core';
-import * as _tanstack_table_core from '@tanstack/table-core';
-import { Store } from '@tanstack/store';
-
+import { Cell, Column, ColumnPinningState, Row, RowData, RowSelectionState, Table, TableFeatures, TableOptions, TableState } from "@tanstack/react-table";
+import { CSSProperties, ReactNode } from "react";
+import { MantineSize, MenuProps } from "@mantine/core";
+import { Store } from "@tanstack/store";
+//#region .types-tmp/components/TMDataGridColumnsPanel.d.ts
 /**
  * The "Manage columns" surface. Reachable from every column header menu and
  * from the grid's burger menu, so it lives on its own and is rendered by
  * `TMDataGrid.ColumnsButton`.
  */
-declare function TMDataGridColumnsPanel(): react.JSX.Element;
-
+declare function TMDataGridColumnsPanel(): import("react").JSX.Element;
+//#endregion
+//#region .types-tmp/components/TMDataGridFilterPanel.d.ts
 /**
  * The MUI-style filter surface: one row per active column filter, each row a
  * column / operator / value triple. It only ever reads and writes the table's
  * `columnFilters` state, so a `manualFiltering` grid gets the same panel for
  * free — the state is forwarded to the server instead of a row model.
  */
-declare function TMDataGridFilterPanel(): react.JSX.Element | null;
-
-type TMDataGridFooterProps = {
-    pageSizeOptions?: ReadonlyArray<number>;
-};
-/**
- * MUI-style pager: "Rows per page · from–to of total · ‹ ›".
- *
- * Row totals come from `table.getRowCount()`, which prefers `options.rowCount`
- * — so a server-paged grid shows the server's total without changes here.
- */
-declare function TMDataGridFooter({ pageSizeOptions, }: TMDataGridFooterProps): react.JSX.Element;
-
+declare function TMDataGridFilterPanel(): import("react").JSX.Element | null;
+//#endregion
+//#region .types-tmp/core/sizes.d.ts
 type TMDataGridSize = MantineSize;
 declare const DEFAULT_TMDATAGRID_SIZE: TMDataGridSize;
 /**
@@ -43,7 +32,8 @@ declare const DEFAULT_TMDATAGRID_SIZE: TMDataGridSize;
 declare const SIZE_ROW_HEIGHT: Record<TMDataGridSize, number>;
 /** Size of the Mantine controls rendered inside the grid chrome. */
 declare const SIZE_CONTROL_SIZE: Record<TMDataGridSize, MantineSize>;
-
+//#endregion
+//#region .types-tmp/core/filterOperators.d.ts
 /**
  * The value shape stored in `columnFilters` for every TMDataGrid column.
  *
@@ -53,8 +43,8 @@ declare const SIZE_CONTROL_SIZE: Record<TMDataGridSize, MantineSize>;
  * `manualFiltering` table (just forward `columnFilters` to the API).
  */
 type TMDataGridFilterValue = {
-    operator: TMDataGridFilterOperator;
-    value: string;
+  operator: TMDataGridFilterOperator;
+  value: string;
 };
 type TMDataGridColumnType = "string" | "number";
 type TMDataGridFilterOperator = "contains" | "equals" | "notEquals" | "startsWith" | "endsWith" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "isEmpty" | "isNotEmpty";
@@ -65,13 +55,26 @@ declare const FILTER_OPERATOR_LABELS: Record<TMDataGridFilterOperator, string>;
  * are treated as inactive for the funnel indicator and for row matching.
  */
 declare function isFilterActive(value: unknown): boolean;
+/**
+ * One-line description of a single filter, as shown on a filter pill.
+ *
+ * The type's default operator is left implicit — "First name: Sofia" reads the
+ * way a person would say it — while any other operator is spelled out, since
+ * that is the part a reader cannot guess.
+ */
+declare function formatFilterLabel({ label, type, filter }: {
+  label: string;
+  type: TMDataGridColumnType;
+  filter: TMDataGridFilterValue;
+}): string;
 /**
  * The single filter function every TMDataGrid column uses. It dispatches on the
  * operator carried by the filter value, which is what lets one column offer
  * "contains" / "does not equal" / "is empty" without redefining the column.
  */
 declare function tmDataGridFilterFn<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: unknown): boolean;
-
+//#endregion
+//#region .types-tmp/core/persistence.d.ts
 type GridState = TableState<TMDataGridFeatures>;
 /**
  * Persistence deliberately does not use Mantine's `useLocalStorage`.
@@ -92,12 +95,12 @@ type GridState = TableState<TMDataGridFeatures>;
  * State slices describing what the user is looking at. Derived from the data,
  * so they can go stale as it changes.
  */
-declare const DATA_STATE_SLICES: readonly ["columnFilters", "globalFilter", "sorting", "pagination"];
+declare const DATA_STATE_SLICES: readonly ["columnFilters", "globalFilter", "sorting", "pagination", "expanded"];
 /**
  * State slices describing how the user configured the grid. Independent of the
  * data, and the ones users notice losing.
  */
-declare const SETTINGS_STATE_SLICES: readonly ["columnVisibility", "columnSizing", "columnOrder", "columnPinning"];
+declare const SETTINGS_STATE_SLICES: readonly ["columnVisibility", "columnSizing", "columnOrder", "columnPinning", "grouping"];
 type TMDataGridDataSlice = (typeof DATA_STATE_SLICES)[number];
 type TMDataGridSettingsSlice = (typeof SETTINGS_STATE_SLICES)[number];
 /**
@@ -110,18 +113,35 @@ type TMDataGridPersistKey<TSlice extends string> = string | readonly [key: strin
 /** Same values as Mantine's `StorageType`, which the package does not re-export. */
 type TMDataGridStorageMode = "localStorage" | "sessionStorage";
 type TMDataGridPersistence = {
-    /** Key for filters, global filter, sorting and pagination. */
-    dataKey?: TMDataGridPersistKey<TMDataGridDataSlice>;
-    /** Key for column visibility, sizing, order and pinning. */
-    settingsKey?: TMDataGridPersistKey<TMDataGridSettingsSlice>;
-    /** Which storage area to use. Defaults to `"localStorage"`. */
-    storageMode?: TMDataGridStorageMode;
-    /** Serializes a payload before it is stored. Defaults to `JSON.stringify`. */
-    serialize?: (value: Partial<GridState>) => string;
-    /** Parses a stored payload. Defaults to `JSON.parse`. */
-    deserialize?: (value: string) => unknown;
+  /** Key for filters, global filter, sorting and pagination. */
+  dataKey?: TMDataGridPersistKey<TMDataGridDataSlice>;
+  /** Key for column visibility, sizing, order and pinning. */
+  settingsKey?: TMDataGridPersistKey<TMDataGridSettingsSlice>;
+  /** Which storage area to use. Defaults to `"localStorage"`. */
+  storageMode?: TMDataGridStorageMode;
+  /** Serializes a payload before it is stored. Defaults to `JSON.stringify`. */
+  serialize?: (value: Partial<GridState>) => string;
+  /** Parses a stored payload. Defaults to `JSON.parse`. */
+  deserialize?: (value: string) => unknown;
 };
-
+//#endregion
+//#region .types-tmp/TMDataGridContext.d.ts
+/**
+ * Row shape the chrome components work against. They only ever touch columns,
+ * rows and cells generically, so the concrete row type is erased at the context
+ * boundary — the same trick Mantine uses for its compound components.
+ */
+type TMDataGridRowData = Record<string, unknown>;
+type TMDataGridContextValue = TMDataGridApi<TMDataGridRowData> & {
+  size: TMDataGridSize;
+  /** Row height in px, already resolved from `size` and `meta.rowHeight`. */
+  rowHeight: number;
+  /** Mantine control size that pairs with `size`. */
+  controlSize: TMDataGridSize;
+};
+declare function useTMDataGridContext(): TMDataGridContextValue;
+//#endregion
+//#region .types-tmp/core/capabilities.d.ts
 /**
  * Table-level feature switches, read straight off the options object.
  *
@@ -134,16 +154,76 @@ type TMDataGridPersistence = {
  * TanStack still decides: these flags are combined with `getCanX()`, which is
  * what applies the per-column overrides.
  */
+/**
+ * How rows are selected — see `selectionMode` on {@link UseTMDataGridOptions}.
+ *
+ * One axis, because the two things a config could set independently — which
+ * chrome selects, and what a bare row click does — cannot both be free: a click
+ * can either toggle a multi-selection or move the highlight, never both. Folding
+ * them into one value makes that conflict unrepresentable rather than something
+ * to warn about.
+ */
+type TMDataGridSelectionMode =
+/** Checkbox column, multi-select. Clicking a row elsewhere does nothing. */
+"checkbox" |
+/** No checkbox column; row click multi-selects, with Ctrl/Shift modifiers. */
+"row" |
+/** Checkbox column multi-selects, and a row click highlights one row. */
+"checkboxAndHighlight" |
+/** No selection at all — a row click only highlights. Master-detail. */
+"highlight";
 type TMDataGridFeatureFlags = {
-    sorting: boolean;
-    filtering: boolean;
-    hiding: boolean;
-    pinning: boolean;
-    resizing: boolean;
-    ordering: boolean;
-    rowSelection: boolean;
+  sorting: boolean;
+  filtering: boolean;
+  hiding: boolean;
+  pinning: boolean;
+  resizing: boolean;
+  ordering: boolean;
+  /** Whether any row selection is possible. Off outright under `"highlight"`. */
+  rowSelection: boolean;
+  /** Defaults to `"checkbox"`. */
+  selectionMode: TMDataGridSelectionMode;
+  /** Whether the generated checkbox column is prepended. */
+  selectColumn: boolean;
+  /** Whether a bare row click toggles the selection. Only under `"row"`. */
+  rowClickSelects: boolean;
+  /**
+   * Whether more than one row can be selected at once — TanStack's
+   * `enableMultiRowSelection`. Off, the grid drops the select-all header
+   * checkbox: TanStack's `toggleAllRowsSelected` only consults `getCanSelect`,
+   * so that control would select every row and walk straight past the limit.
+   *
+   * A per-row predicate counts as on, since some rows may still multi-select.
+   */
+  multiRowSelection: boolean;
+  /** Whether a selected row takes the highlight colour. Follows the mode. */
+  showSelectedBackground: boolean;
+  /**
+   * The single highlighted row — clicking a row highlights it, for a detail
+   * panel to follow. State of its own, not a slice of `rowSelection`, which is
+   * what lets it coexist with a checkbox multi-selection.
+   */
+  highlightRow: boolean;
+  /**
+   * The one default-off flag: pagination must be asked for, either with the
+   * grid's `enablePagination` or implicitly by declaring `manualPagination`.
+   * Off, the grid renders every filtered row and relies on virtualization.
+   */
+  pagination: boolean;
+  /**
+   * Row grouping: the "Group by" items in the header menu and the generated
+   * tree column. On unless `enableGrouping: false`, since an ungrouped grid
+   * looks and behaves exactly as it did before — `grouping` starts empty, and
+   * an empty grouping state passes straight through the row model.
+   *
+   * The exception is `manualPagination`, where the client holds one page rather
+   * than the whole set: grouping that page would build groups out of an
+   * arbitrary slice and quietly show wrong counts. A server-side grid that does
+   * its own grouping can still say `enableGrouping: true` to override.
+   */
+  grouping: boolean;
 };
-declare function readFeatureFlags<TData extends RowData>(options: Pick<UseTMDataGridOptions<TData>, "enableSorting" | "enableColumnFilters" | "enableHiding" | "enableColumnPinning" | "enableColumnResizing" | "enableColumnOrdering" | "enableRowSelection">): TMDataGridFeatureFlags;
+declare function readFeatureFlags<TData extends RowData>(options: Pick<UseTMDataGridOptions<TData>, "enableSorting" | "enableColumnFilters" | "enableHiding" | "enableColumnPinning" | "enableColumnResizing" | "enableColumnOrdering" | "enableRowSelection" | "enableMultiRowSelection" | "selectionMode" | "showSelectedBackground" | "enablePagination" | "manualPagination" | "enableGrouping">): TMDataGridFeatureFlags;
 /**
  * What one column's header may offer.
  *
@@ -155,195 +235,229 @@ declare function readFeatureFlags<TData extends RowData>(options: Pick<UseTMData
  * | Pin to left / right       | `enableColumnPinning` / `enablePinning` |
  * | Resize dragging           | `enableColumnResizing` / `enableResizing` |
  * | Header dragging, Move left / right | `enableColumnOrdering` / `meta.enableOrdering` |
+ * | Group by / Ungroup        | `enableGrouping` (table or column) |
  */
 type TMDataGridColumnCapabilities = {
-    canSort: boolean;
-    canFilter: boolean;
-    canHide: boolean;
-    canPin: boolean;
-    canResize: boolean;
-    canReorder: boolean;
+  canSort: boolean;
+  canFilter: boolean;
+  canHide: boolean;
+  canPin: boolean;
+  canResize: boolean;
+  canReorder: boolean;
+  canGroup: boolean;
 };
 declare function getColumnCapabilities(column: Column<TMDataGridFeatures, TMDataGridRowData, unknown>, features: TMDataGridFeatureFlags): TMDataGridColumnCapabilities;
 /** The same questions, asked of the whole grid — used to hide toolbar buttons. */
 type TMDataGridCapabilities = {
-    canSortAny: boolean;
-    canFilterAny: boolean;
-    canHideAny: boolean;
-    canPinAny: boolean;
-    canReorderAny: boolean;
-    canSelectRows: boolean;
+  canSortAny: boolean;
+  canFilterAny: boolean;
+  canHideAny: boolean;
+  canPinAny: boolean;
+  canReorderAny: boolean;
+  canGroupAny: boolean;
+  canSelectRows: boolean;
+  canPaginate: boolean;
 };
-declare function getGridCapabilities(table: TMDataGridTable$1<TMDataGridRowData>, features: TMDataGridFeatureFlags): TMDataGridCapabilities;
-
-declare const SELECT_COLUMN_ID = "__select__";
+declare function getGridCapabilities(table: TMDataGridTable<TMDataGridRowData>, features: TMDataGridFeatureFlags): TMDataGridCapabilities;
+//#endregion
+//#region .types-tmp/useTMDataGrid.d.ts
 /** Per-column configuration the TMDataGrid chrome reads. */
 type TMDataGridColumnMeta = {
-    /** Name shown in menus and the column manager. Falls back to a string header. */
-    label?: string;
-    /** Drives which filter operators are offered. Defaults to `"string"`. */
-    type?: TMDataGridColumnType;
-    /** Share of the leftover width this column claims. Defaults to `1`. */
-    flex?: number;
-    align?: "left" | "right" | "center";
-    /**
-     * `false` keeps the column where it is: no header dragging, no move items.
-     * Column ordering is the one feature TanStack defines no column option for,
-     * so its switch lives here rather than on the column definition.
-     */
-    enableOrdering?: boolean;
+  /** Name shown in menus and the column manager. Falls back to a string header. */
+  label?: string;
+  /** Drives which filter operators are offered. Defaults to `"string"`. */
+  type?: TMDataGridColumnType;
+  /** Share of the leftover width this column claims. Defaults to `1`. */
+  flex?: number;
+  align?: "left" | "right" | "center";
+  /**
+   * `false` keeps the column where it is: no header dragging, no move items.
+   * Column ordering is the one feature TanStack defines no column option for,
+   * so its switch lives here rather than on the column definition.
+   */
+  enableOrdering?: boolean;
 };
 /** Grid-wide configuration passed through `options.meta`. */
 type TMDataGridTableMeta = {
-    loading?: boolean;
-    noResultsLabel?: string;
-    /** Row height used by the virtualizer. Defaults to `52`. */
-    rowHeight?: number;
-    /**
-     * Unfiltered row total. Only needed for server-driven grids, where the client
-     * never holds the full data set — `TMDataGrid.SummaryCount` uses it as denominator.
-     */
-    totalRowCount?: number;
+  loading?: boolean;
+  noResultsLabel?: string;
+  /** Row height used by the virtualizer. Defaults to `52`. */
+  rowHeight?: number;
+  /**
+   * Unfiltered row total. Only needed for server-driven grids, where the client
+   * never holds the full data set — `TMDataGrid.SummaryCount` uses it as denominator.
+   */
+  totalRowCount?: number;
 };
 /**
  * Every feature the TMDataGrid chrome can drive. Defined at module scope so the
  * reference stays stable across renders (see the TanStack table-state skill).
  */
 declare const tmDataGridFeatures: {
-    columnFilteringFeature: _tanstack_table_core.TableFeature;
-    globalFilteringFeature: _tanstack_table_core.TableFeature;
-    rowSortingFeature: _tanstack_table_core.TableFeature;
-    rowPaginationFeature: _tanstack_table_core.TableFeature;
-    rowSelectionFeature: _tanstack_table_core.TableFeature;
-    columnPinningFeature: _tanstack_table_core.TableFeature;
-    columnVisibilityFeature: _tanstack_table_core.TableFeature;
-    columnOrderingFeature: _tanstack_table_core.TableFeature;
-    columnSizingFeature: _tanstack_table_core.TableFeature;
-    columnResizingFeature: _tanstack_table_core.TableFeature;
-    columnFacetingFeature: _tanstack_table_core.TableFeature;
-    filteredRowModel: (table: Table<any, any>) => () => _tanstack_table_core.RowModel<any, any>;
-    sortedRowModel: (table: Table<any, any>) => () => _tanstack_table_core.RowModel<any, any>;
-    paginatedRowModel: (table: Table<any, any>) => () => _tanstack_table_core.RowModel<any, any>;
-    facetedRowModel: (table: Table<any, any>, columnId: string) => () => _tanstack_table_core.RowModel<any, any>;
-    facetedMinMaxValues: (table: Table<_tanstack_table_core.TableFeatures, any>, columnId: string) => () => undefined | [number, number];
-    facetedUniqueValues: (table: Table<_tanstack_table_core.TableFeatures, any>, columnId: string) => () => Map<any, number>;
-    filterFns: {
-        tmDataGrid: typeof tmDataGridFilterFn;
-        arrIncludes: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        arrIncludesAll: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        arrHas: <TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean;
-        arrIncludesSome: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        between: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        betweenInclusive: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        equals: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        equalsString: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        inNumberRange: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: [number, number]) => boolean) & {
-            resolveFilterValue: (val: [any, any]) => readonly [number, number];
-            autoRemove: (val: any) => boolean;
-        };
-        includesString: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        includesStringSensitive: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        weakEquals: (<TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
+  columnFilteringFeature: import("@tanstack/table-core").TableFeature;
+  globalFilteringFeature: import("@tanstack/table-core").TableFeature;
+  rowSortingFeature: import("@tanstack/table-core").TableFeature;
+  rowPaginationFeature: import("@tanstack/table-core").TableFeature;
+  rowSelectionFeature: import("@tanstack/table-core").TableFeature;
+  columnPinningFeature: import("@tanstack/table-core").TableFeature;
+  columnVisibilityFeature: import("@tanstack/table-core").TableFeature;
+  columnOrderingFeature: import("@tanstack/table-core").TableFeature;
+  columnSizingFeature: import("@tanstack/table-core").TableFeature;
+  columnResizingFeature: import("@tanstack/table-core").TableFeature;
+  columnFacetingFeature: import("@tanstack/table-core").TableFeature;
+  columnGroupingFeature: import("@tanstack/table-core").TableFeature;
+  rowExpandingFeature: import("@tanstack/table-core").TableFeature;
+  filteredRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  groupedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  sortedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  expandedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  paginatedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  facetedRowModel: (table: Table<any, any>, columnId: string) => () => import("@tanstack/table-core").RowModel<any, any>;
+  facetedMinMaxValues: (table: Table<import("@tanstack/table-core").TableFeatures, any>, columnId: string) => () => undefined | [number, number];
+  facetedUniqueValues: (table: Table<import("@tanstack/table-core").TableFeatures, any>, columnId: string) => () => Map<any, number>;
+  filterFns: {
+    arrIncludes: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    arrIncludesAll: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+      autoRemove: (val: any) => boolean;
     };
-    sortFns: {
-        alphanumeric: <TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData>, rowB: _tanstack_table_core.Row<TFeatures, TData>, columnId: string) => number;
-        alphanumericCaseSensitive: <TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData>, rowB: _tanstack_table_core.Row<TFeatures, TData>, columnId: string) => number;
-        basic: <TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData>, rowB: _tanstack_table_core.Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
-        datetime: <TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData>, rowB: _tanstack_table_core.Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
-        text: <TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData>, rowB: _tanstack_table_core.Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
-        textCaseSensitive: <TFeatures extends _tanstack_table_core.TableFeatures, TData extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData>, rowB: _tanstack_table_core.Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
+    arrHas: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean;
+    arrIncludesSome: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+      autoRemove: (val: any) => boolean;
     };
-    tableMeta: TMDataGridTableMeta;
-    columnMeta: TMDataGridColumnMeta;
+    between: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    betweenInclusive: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    equals: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    equalsString: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    inNumberRange: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: [number, number]) => boolean) & {
+      resolveFilterValue: (val: [any, any]) => readonly [number, number];
+      autoRemove: (val: any) => boolean;
+    };
+    includesString: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    includesStringSensitive: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    weakEquals: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    tmDataGrid: typeof tmDataGridFilterFn;
+  };
+  sortFns: {
+    alphanumeric: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData>, rowB: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string) => number;
+    alphanumericCaseSensitive: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData>, rowB: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string) => number;
+    basic: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData>, rowB: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
+    datetime: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData>, rowB: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
+    text: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData>, rowB: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
+    textCaseSensitive: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData>, rowB: import("@tanstack/table-core").Row<TFeatures, TData>, columnId: string) => 0 | 1 | -1;
+  };
+  aggregationFns: {
+    sum: typeof import("@tanstack/table-core").aggregationFn_sum;
+    min: typeof import("@tanstack/table-core").aggregationFn_min;
+    max: typeof import("@tanstack/table-core").aggregationFn_max;
+    extent: typeof import("@tanstack/table-core").aggregationFn_extent;
+    mean: typeof import("@tanstack/table-core").aggregationFn_mean;
+    median: typeof import("@tanstack/table-core").aggregationFn_median;
+    unique: typeof import("@tanstack/table-core").aggregationFn_unique;
+    uniqueCount: typeof import("@tanstack/table-core").aggregationFn_uniqueCount;
+    count: typeof import("@tanstack/table-core").aggregationFn_count;
+  };
+  tableMeta: TMDataGridTableMeta;
+  columnMeta: TMDataGridColumnMeta;
 };
 type TMDataGridFeatures = typeof tmDataGridFeatures;
-type TMDataGridTable$1<TData extends RowData> = Table<TMDataGridFeatures, TData>;
-declare function createTMDataGridColumnHelper<TData extends RowData>(): _tanstack_table_core.ColumnHelper<{
-    columnFilteringFeature: _tanstack_table_core.TableFeature;
-    globalFilteringFeature: _tanstack_table_core.TableFeature;
-    rowSortingFeature: _tanstack_table_core.TableFeature;
-    rowPaginationFeature: _tanstack_table_core.TableFeature;
-    rowSelectionFeature: _tanstack_table_core.TableFeature;
-    columnPinningFeature: _tanstack_table_core.TableFeature;
-    columnVisibilityFeature: _tanstack_table_core.TableFeature;
-    columnOrderingFeature: _tanstack_table_core.TableFeature;
-    columnSizingFeature: _tanstack_table_core.TableFeature;
-    columnResizingFeature: _tanstack_table_core.TableFeature;
-    columnFacetingFeature: _tanstack_table_core.TableFeature;
-    filteredRowModel: (table: Table<any, any>) => () => _tanstack_table_core.RowModel<any, any>;
-    sortedRowModel: (table: Table<any, any>) => () => _tanstack_table_core.RowModel<any, any>;
-    paginatedRowModel: (table: Table<any, any>) => () => _tanstack_table_core.RowModel<any, any>;
-    facetedRowModel: (table: Table<any, any>, columnId: string) => () => _tanstack_table_core.RowModel<any, any>;
-    facetedMinMaxValues: (table: Table<_tanstack_table_core.TableFeatures, any>, columnId: string) => () => undefined | [number, number];
-    facetedUniqueValues: (table: Table<_tanstack_table_core.TableFeatures, any>, columnId: string) => () => Map<any, number>;
-    filterFns: {
-        tmDataGrid: typeof tmDataGridFilterFn;
-        arrIncludes: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        arrIncludesAll: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        arrHas: <TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean;
-        arrIncludesSome: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        between: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        betweenInclusive: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        equals: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        equalsString: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        inNumberRange: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: [number, number]) => boolean) & {
-            resolveFilterValue: (val: [any, any]) => readonly [number, number];
-            autoRemove: (val: any) => boolean;
-        };
-        includesString: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        includesStringSensitive: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
-        weakEquals: (<TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(row: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
-            autoRemove: (val: any) => boolean;
-        };
+type TMDataGridTable<TData extends RowData> = Table<TMDataGridFeatures, TData>;
+declare function createTMDataGridColumnHelper<TData extends RowData>(): import("@tanstack/table-core").ColumnHelper<{
+  columnFilteringFeature: import("@tanstack/table-core").TableFeature;
+  globalFilteringFeature: import("@tanstack/table-core").TableFeature;
+  rowSortingFeature: import("@tanstack/table-core").TableFeature;
+  rowPaginationFeature: import("@tanstack/table-core").TableFeature;
+  rowSelectionFeature: import("@tanstack/table-core").TableFeature;
+  columnPinningFeature: import("@tanstack/table-core").TableFeature;
+  columnVisibilityFeature: import("@tanstack/table-core").TableFeature;
+  columnOrderingFeature: import("@tanstack/table-core").TableFeature;
+  columnSizingFeature: import("@tanstack/table-core").TableFeature;
+  columnResizingFeature: import("@tanstack/table-core").TableFeature;
+  columnFacetingFeature: import("@tanstack/table-core").TableFeature;
+  columnGroupingFeature: import("@tanstack/table-core").TableFeature;
+  rowExpandingFeature: import("@tanstack/table-core").TableFeature;
+  filteredRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  groupedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  sortedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  expandedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  paginatedRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  facetedRowModel: (table: Table<any, any>, columnId: string) => () => import("@tanstack/table-core").RowModel<any, any>;
+  facetedMinMaxValues: (table: Table<import("@tanstack/table-core").TableFeatures, any>, columnId: string) => () => undefined | [number, number];
+  facetedUniqueValues: (table: Table<import("@tanstack/table-core").TableFeatures, any>, columnId: string) => () => Map<any, number>;
+  filterFns: {
+    arrIncludes: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    arrIncludesAll: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    arrHas: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean;
+    arrIncludesSome: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    between: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    betweenInclusive: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValues: [unknown, unknown]) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    equals: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
     };
-    sortFns: {
-        alphanumeric: <TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData_1>, rowB: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string) => number;
-        alphanumericCaseSensitive: <TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData_1>, rowB: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string) => number;
-        basic: <TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData_1>, rowB: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
-        datetime: <TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData_1>, rowB: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
-        text: <TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData_1>, rowB: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
-        textCaseSensitive: <TFeatures extends _tanstack_table_core.TableFeatures, TData_1 extends RowData>(rowA: _tanstack_table_core.Row<TFeatures, TData_1>, rowB: _tanstack_table_core.Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
+    equalsString: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
     };
-    tableMeta: TMDataGridTableMeta;
-    columnMeta: TMDataGridColumnMeta;
+    inNumberRange: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: [number, number]) => boolean) & {
+      resolveFilterValue: (val: [any, any]) => readonly [number, number];
+      autoRemove: (val: any) => boolean;
+    };
+    includesString: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    includesStringSensitive: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    weakEquals: (<TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(row: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string, filterValue: unknown) => boolean) & {
+      autoRemove: (val: any) => boolean;
+    };
+    tmDataGrid: typeof tmDataGridFilterFn;
+  };
+  sortFns: {
+    alphanumeric: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData_1>, rowB: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string) => number;
+    alphanumericCaseSensitive: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData_1>, rowB: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string) => number;
+    basic: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData_1>, rowB: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
+    datetime: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData_1>, rowB: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
+    text: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData_1>, rowB: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
+    textCaseSensitive: <TFeatures extends import("@tanstack/table-core").TableFeatures, TData_1 extends RowData>(rowA: import("@tanstack/table-core").Row<TFeatures, TData_1>, rowB: import("@tanstack/table-core").Row<TFeatures, TData_1>, columnId: string) => 0 | 1 | -1;
+  };
+  aggregationFns: {
+    sum: typeof import("@tanstack/table-core").aggregationFn_sum;
+    min: typeof import("@tanstack/table-core").aggregationFn_min;
+    max: typeof import("@tanstack/table-core").aggregationFn_max;
+    extent: typeof import("@tanstack/table-core").aggregationFn_extent;
+    mean: typeof import("@tanstack/table-core").aggregationFn_mean;
+    median: typeof import("@tanstack/table-core").aggregationFn_median;
+    unique: typeof import("@tanstack/table-core").aggregationFn_unique;
+    uniqueCount: typeof import("@tanstack/table-core").aggregationFn_uniqueCount;
+    count: typeof import("@tanstack/table-core").aggregationFn_count;
+  };
+  tableMeta: TMDataGridTableMeta;
+  columnMeta: TMDataGridColumnMeta;
 }, TData>;
 /**
  * Chrome state that is *not* table state: which panels are open, and which
@@ -351,50 +465,143 @@ declare function createTMDataGridColumnHelper<TData extends RowData>(): _tanstac
  * subscribe to it the same way they subscribe to `table.store`.
  */
 type TMDataGridUiState = {
-    filterPanelOpen: boolean;
-    columnsPanelOpen: boolean;
-    /** Column whose filter row should be focused when the panel opens. */
-    filterPanelColumnId: string | null;
-    /**
-     * Column being dragged by its header, if any. Held here rather than read from
-     * `dataTransfer`, which browsers keep unreadable until the drop.
-     */
-    draggedColumnId: string | null;
+  filterPanelOpen: boolean;
+  columnsPanelOpen: boolean;
+  /** Column whose filter row should be focused when the panel opens. */
+  filterPanelColumnId: string | null;
+  /**
+   * Column being dragged by its header, if any. Held here rather than read from
+   * `dataTransfer`, which browsers keep unreadable until the drop.
+   */
+  draggedColumnId: string | null;
+  /**
+   * The single highlighted row — the one a detail panel would be showing. Its
+   * own concept, not a slice of `rowSelection`: under
+   * `selectionMode: "checkboxAndHighlight"` the two coexist, and TanStack's one
+   * selection map cannot hold both.
+   *
+   * Not pruned when the row is filtered out, paged away or dropped from `data`,
+   * matching how TanStack treats `rowSelection` — nothing there resets it
+   * either. The row simply renders unhighlighted, and highlights again if it
+   * comes back.
+   */
+  highlightedRowId: string | null;
+  /** The pivot a shift-click extends from. See resolveRowSelectionClick. */
+  selectionAnchorRowId: string | null;
 };
 type TMDataGridUiActions = {
-    openFilterPanel: (columnId?: string | null) => void;
-    closeFilterPanel: () => void;
-    setColumnsPanelOpen: (open: boolean) => void;
-    toggleColumnsPanel: () => void;
-    startColumnDrag: (columnId: string) => void;
-    endColumnDrag: () => void;
+  openFilterPanel: (columnId?: string | null) => void;
+  closeFilterPanel: () => void;
+  setColumnsPanelOpen: (open: boolean) => void;
+  toggleColumnsPanel: () => void;
+  startColumnDrag: (columnId: string) => void;
+  endColumnDrag: () => void;
+  /**
+   * Moves the active row, or clears it with `null` — which is how a consumer
+   * closing its detail panel puts the grid back in step.
+   */
+  setHighlightedRow: (rowId: string | null) => void;
+  setSelectionAnchor: (rowId: string | null) => void;
 };
 type TMDataGridUiStore = Store<TMDataGridUiState, TMDataGridUiActions>;
 /** What `useTMDataGrid` returns — spread straight onto `<TMDataGrid />`. */
 type TMDataGridApi<TData extends RowData> = {
-    table: TMDataGridTable$1<TData>;
-    ui: TMDataGridUiStore;
-    /** Table-level feature switches, re-read from options on every render. */
-    features: TMDataGridFeatureFlags;
+  table: TMDataGridTable<TData>;
+  ui: TMDataGridUiStore;
+  /** Table-level feature switches, re-read from options on every render. */
+  features: TMDataGridFeatureFlags;
 };
 type UseTMDataGridOptions<TData extends RowData> = Omit<TableOptions<TMDataGridFeatures, TData>, "features"> & {
-    /**
-     * Restore and persist table state across mounts. Two keys, because the two
-     * kinds of state have different lifetimes — see {@link TMDataGridPersistence}.
-     *
-     * Keep the object referentially stable (module scope or `useMemo`); it is a
-     * dependency of the subscription that writes back.
-     */
-    persist?: TMDataGridPersistence;
-    /**
-     * Header drag-and-drop and the move items in the column menu. Defaults to
-     * `true`.
-     *
-     * The one feature switch the grid defines itself: TanStack's
-     * `columnOrderingFeature` ships state and APIs but no `enable` option, since
-     * reordering is entirely a matter of interface.
-     */
-    enableColumnOrdering?: boolean;
+  /**
+   * Restore and persist table state across mounts. Two keys, because the two
+   * kinds of state have different lifetimes — see {@link TMDataGridPersistence}.
+   *
+   * Keep the object referentially stable (module scope or `useMemo`); it is a
+   * dependency of the subscription that writes back.
+   */
+  persist?: TMDataGridPersistence;
+  /**
+   * Header drag-and-drop and the move items in the column menu. Defaults to
+   * `true`.
+   *
+   * The one feature switch the grid defines itself: TanStack's
+   * `columnOrderingFeature` ships state and APIs but no `enable` option, since
+   * reordering is entirely a matter of interface.
+   */
+  enableColumnOrdering?: boolean;
+  /**
+   * Client-side pagination and the built-in `TMDataGrid.Footer` pager.
+   * Defaults to `false`: the grid renders every filtered row and relies on
+   * virtualization.
+   *
+   * The second grid-defined switch (TanStack defines no `enablePagination`
+   * option). `manualPagination: true` implies it — a server-paged grid needs
+   * no extra flag.
+   */
+  enablePagination?: boolean;
+  /**
+   * How rows are selected. Defaults to `"checkbox"`.
+   *
+   * | Mode | Checkbox column | Row click |
+   * | ---- | --------------- | --------- |
+   * | `"checkbox"` | yes, multi-select | nothing |
+   * | `"row"` | no | multi-selects, Ctrl/Shift modifiers |
+   * | `"checkboxAndHighlight"` | yes, multi-select | highlights one row |
+   * | `"highlight"` | no | highlights one row, no selection at all |
+   *
+   * One option rather than two, so the combination that cannot work — a click
+   * that both toggles a multi-selection and moves the highlight — is not
+   * expressible.
+   *
+   * The first two write to TanStack's `rowSelection`. The highlight is separate
+   * state, which is what lets `"checkboxAndHighlight"` run both at once: tick
+   * rows for a bulk action, click one to open its detail panel. See
+   * `defaultHighlightedRowId` / `onHighlightedRowChange`.
+   *
+   * `enableRowSelection` still gates the selection half, predicate form
+   * included; under `"highlight"` there is nothing for it to gate.
+   */
+  selectionMode?: TMDataGridSelectionMode;
+  /**
+   * Give selected rows the highlight background. Defaults to `true` under
+   * `selectionMode: "row"`, where the highlight is the only feedback a click
+   * gives, and `false` under `"checkbox"`, where the box already shows it.
+   *
+   * The colour is the `--dg-row-selected-bg` CSS variable, so it can be changed
+   * without turning the flag on or off:
+   *
+   * ```tsx
+   * <TMDataGrid
+   *   {...grid}
+   *   style={{ "--dg-row-selected-bg": "var(--mantine-color-blue-0)" }}
+   * />
+   * ```
+   */
+  showSelectedBackground?: boolean;
+  /**
+   * The row that starts out highlighted, under a `selectionMode` that has a
+   * highlight. Read once on mount, like `initialState`.
+   *
+   * The grid never persists the highlighted row. Pair this with
+   * {@link onHighlightedRowChange} and keep it wherever it belongs — for a
+   * detail panel that is usually the route, which gets you a shareable link and
+   * a working back button as well as surviving a reload:
+   *
+   * ```tsx
+   * const { rowId } = useParams();
+   * useTMDataGrid({
+   *   selectionMode: "highlight",
+   *   defaultHighlightedRowId: rowId,
+   *   onHighlightedRowChange: (id) => navigate(id ? `/employees/${id}` : "/employees"),
+   * });
+   * ```
+   */
+  defaultHighlightedRowId?: string | null;
+  /**
+   * Called with the newly highlighted row id, or `null` when it is cleared.
+   * Fires for `ui.actions.setHighlightedRow` too, not only for clicks.
+   */
+  onHighlightedRowChange?: (rowId: string | null) => void;
 };
 /**
  * Builds a TMDataGrid table plus its chrome store.
@@ -403,81 +610,209 @@ type UseTMDataGridOptions<TData extends RowData> = Omit<TableOptions<TMDataGridF
  * only needs `manualPagination` / `manualFiltering` / `manualSorting`,
  * `rowCount` and the matching `onXChange` callbacks — the chrome reads
  * `getRowCount()` / `getPageCount()` / `getPaginatedRowModel()`, all of which
- * already respect manual mode.
+ * already respect manual mode. `manualPagination` also switches the pagination
+ * flag on, so `<TMDataGrid.Footer />` renders its pager without further
+ * options.
  */
-declare function useTMDataGrid<TData extends RowData>({ persist, enableColumnOrdering, ...options }: UseTMDataGridOptions<TData>): TMDataGridApi<TData>;
+declare function useTMDataGrid<TData extends RowData>({ persist, enableColumnOrdering, enablePagination, selectionMode, showSelectedBackground, defaultHighlightedRowId, onHighlightedRowChange, ...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.
  */
 declare function openColumnFilter<TData extends RowData>(api: TMDataGridApi<TData>, columnId: string): void;
-
+//#endregion
+//#region .types-tmp/components/TMDataGridFilterPills.d.ts
+type TMDataGridFilterPillsProps<TData extends RowData> = {
+  /** The object returned by `useTMDataGrid`. */
+  api: TMDataGridApi<TData>;
+  /** Mantine size of the pills. Defaults to `"sm"`. */
+  size?: TMDataGridSize;
+  /** "Clear all" button, shown once two filters are active. Defaults to `true`. */
+  showClearAll?: boolean;
+  /**
+   * Replaces what a click on a pill's label does. The default opens the grid's
+   * filter panel on that column.
+   */
+  onPillClick?: (columnId: string) => void;
+  className?: string;
+};
 /**
- * Row shape the chrome components work against. They only ever touch columns,
- * rows and cells generically, so the concrete row type is erased at the context
- * boundary — the same trick Mantine uses for its compound components.
+ * One pill per active filter — `First name: Sofia ✕` — with the ✕ clearing that
+ * filter and a click on the label opening the filter panel on its column.
+ *
+ * The one grid component that takes the api as a prop instead of reading
+ * context, so it can live anywhere: a page header, a card title, a breadcrumb
+ * row. Renders nothing while no filter is active.
+ *
+ * ```tsx
+ * const grid = useTMDataGrid({ data, columns });
+ *
+ * <Group>
+ *   <Title order={3}>Employees</Title>
+ *   <TMDataGridFilterPills api={grid} />
+ * </Group>
+ * ```
+ *
+ * Half-typed filters are left out: a filter that is not narrowing the rows yet
+ * has nothing to report, which is the same rule the funnel indicator uses.
  */
-type TMDataGridRowData = Record<string, unknown>;
-type TMDataGridContextValue = TMDataGridApi<TMDataGridRowData> & {
-    size: TMDataGridSize;
-    /** Row height in px, already resolved from `size` and `meta.rowHeight`. */
-    rowHeight: number;
-    /** Mantine control size that pairs with `size`. */
-    controlSize: TMDataGridSize;
+declare function TMDataGridFilterPills<TData extends RowData>({ api, size, showClearAll, onPillClick, className }: TMDataGridFilterPillsProps<TData>): import("react").JSX.Element | null;
+//#endregion
+//#region .types-tmp/components/TMDataGridFooter.d.ts
+/** Distilled pagination state and actions for building a custom pager. */
+type TMDataGridPaginationApi = {
+  pageIndex: number;
+  pageSize: number;
+  /** `-1` when a manual grid declares `pageCount: -1` (unknown total). */
+  pageCount: number;
+  rowCount: number;
+  canPreviousPage: boolean;
+  canNextPage: boolean;
+  setPageIndex: (pageIndex: number) => void;
+  setPageSize: (pageSize: number) => void;
+  previousPage: () => void;
+  nextPage: () => void;
+  firstPage: () => void;
+  lastPage: () => void;
 };
-declare function useTMDataGridContext(): TMDataGridContextValue;
-
+/**
+ * Reads {@link TMDataGridPaginationApi} off a table. The Footer feeds it to the
+ * `pagination` render prop; a pager living outside the Footer can call it with
+ * the table from `useTMDataGrid` directly.
+ */
+declare function getTMDataGridPaginationApi<TData extends RowData>(table: TMDataGridTable<TData>): TMDataGridPaginationApi;
+type TMDataGridFooterProps = {
+  pageSizeOptions?: ReadonlyArray<number>;
+  /** Replaces the built-in pager. Receives the distilled pagination API. */
+  pagination?: (api: TMDataGridPaginationApi) => ReactNode;
+};
+/**
+ * MUI-style pager: "Rows per page · from–to of total · ‹ ›".
+ *
+ * Renders nothing unless pagination is enabled (`enablePagination` or
+ * `manualPagination`) — the footer is a pager; extra footer content belongs in
+ * your own layout.
+ *
+ * Row totals come from `table.getRowCount()`, which prefers `options.rowCount`
+ * — so a server-paged grid shows the server's total without changes here.
+ */
+declare function TMDataGridFooter({ pageSizeOptions, pagination }: TMDataGridFooterProps): import("react").JSX.Element | null;
+//#endregion
+//#region .types-tmp/components/TMDataGridTable.d.ts
 /** Where a column sits relative to the pinned regions, resolved once per render. */
 type TMDataGridColumnLayout = {
-    pinnedAt: "left" | "right" | false;
-    /** Distance in px from the grid's left or right edge. */
-    offset: number;
-    /** Last left-pinned / first right-pinned column — the one that casts the edge. */
-    isBoundary: boolean;
+  pinnedAt: "left" | "right" | false;
+  /** Distance in px from the grid's left or right edge. */
+  offset: number;
+  /** Last left-pinned / first right-pinned column — the one that casts the edge. */
+  isBoundary: boolean;
+};
+/** What a `rowContextMenu` render prop is handed for the right-clicked row. */
+type TMDataGridRowContextMenuArgs<TData extends RowData> = {
+  table: Table<TMDataGridFeatures, TData>;
+  row: Row<TMDataGridFeatures, TData>;
+  /**
+   * The cell under the pointer. `null` only when the right-click landed on the
+   * row but on no cell — which a custom cell renderer that stops propagation
+   * can cause.
+   */
+  cell: Cell<TMDataGridFeatures, TData, unknown> | null;
+  /**
+   * Closes the menu. `Menu.Item` already closes on click (Mantine's
+   * `closeOnItemClick`), so this is for content that isn't a menu item.
+   */
+  close: () => void;
 };
+/**
+ * Builds the contents of a row's context menu — `Menu.Item`, `Menu.Label`,
+ * `Menu.Divider`, `Menu.Sub`, or any other node. The grid owns the `Menu` and
+ * its `Menu.Dropdown`; this fills the dropdown.
+ */
+type TMDataGridRowContextMenu<TData extends RowData> = (args: TMDataGridRowContextMenuArgs<TData>) => ReactNode;
 type TMDataGridTableProps<TData extends RowData> = {
-    /** Called when a body row is clicked. */
-    onRowClick?: (row: Row<TMDataGridFeatures, TData>) => void;
+  /**
+   * Called when a body row is clicked. Runs in addition to row selection under
+   * `selectionMode: "row"`, not instead of it.
+   */
+  onRowClick?: (row: Row<TMDataGridFeatures, TData>) => void;
+  /**
+   * Contents of the menu a right-click on a row opens, at the pointer. Return
+   * `null` to leave a row without one — the browser's own menu stays suppressed
+   * either way.
+   *
+   * ```tsx
+   * <TMDataGrid.Table<Employee>
+   *   rowContextMenu={({ row, close }) => (
+   *     <>
+   *       <Menu.Label>{row.original.firstName}</Menu.Label>
+   *       <Menu.Item onClick={() => open(row.original.id)}>Open</Menu.Item>
+   *       <Menu.Divider />
+   *       <Menu.Item color="red" onClick={() => remove(row.original.id)}>
+   *         Delete
+   *       </Menu.Item>
+   *     </>
+   *   )}
+   * />
+   * ```
+   *
+   * Called during render, and only for the row whose menu is open — so it stays
+   * a pure function of the row, and cost per row does not matter.
+   */
+  rowContextMenu?: TMDataGridRowContextMenu<TData>;
+  /**
+   * Passed to the Mantine `Menu` the grid wraps the row in — `width`, `shadow`,
+   * `position`, `transitionProps` and the rest. Its open state is the grid's.
+   */
+  rowContextMenuProps?: Omit<MenuProps, "opened" | "onChange" | "children">;
 };
 /**
  * The scrollable grid surface. Always virtualized: only the rows inside the
- * viewport (plus overscan) are mounted, regardless of page size.
+ * 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`).
  */
-declare function TMDataGridTable<TData extends RowData = TMDataGridRowData>({ onRowClick, }: TMDataGridTableProps<TData>): react.JSX.Element;
-
+declare function TMDataGridTable$1<TData extends RowData = TMDataGridRowData>({ onRowClick, rowContextMenu, rowContextMenuProps }: TMDataGridTableProps<TData>): import("react").JSX.Element;
+//#endregion
+//#region .types-tmp/components/TMDataGridToolbar.d.ts
 /** Row above the grid. Compose it from the pieces below, or anything else. */
 declare function TMDataGridToolbar({ children }: {
-    children?: ReactNode;
-}): react.JSX.Element;
+  children?: ReactNode;
+}): import("react").JSX.Element;
 /** Pushes the following toolbar items to the right. */
-declare function TMDataGridToolbarSpacer(): react.JSX.Element;
+declare function TMDataGridToolbarSpacer(): import("react").JSX.Element;
 /**
  * Visible rows over total rows. On a server-driven grid, set
  * `meta.totalRowCount` for the denominator — the client never sees every row.
  */
 declare function TMDataGridSummaryCount({ children }: {
-    children?: ReactNode;
-}): react.JSX.Element;
+  children?: ReactNode;
+}): import("react").JSX.Element;
 /**
  * Burger menu in the grid's top-right corner — opens "Manage columns".
  * Renders nothing when no column can be hidden (`enableHiding: false`).
  */
-declare function TMDataGridColumnsButton(): react.JSX.Element | null;
+declare function TMDataGridColumnsButton(): import("react").JSX.Element | null;
 /**
  * Toggles the filter panel, seeding a filter row on the first filterable column.
  * Renders nothing when no column can be filtered (`enableColumnFilters: false`).
  */
-declare function TMDataGridFilterButton(): react.JSX.Element | null;
-
+declare function TMDataGridFilterButton(): import("react").JSX.Element | null;
+//#endregion
+//#region .types-tmp/components/TMDataGrid.d.ts
 type TMDataGridProps<TData extends RowData> = TMDataGridApi<TData> & {
-    children: ReactNode;
-    /**
-     * Mantine size scale. Drives row height, font size, cell padding and the
-     * size of the controls in the chrome. `meta.rowHeight` still wins if set.
-     */
-    size?: TMDataGridSize;
-    className?: string;
-    style?: CSSProperties;
+  children: ReactNode;
+  /**
+   * Mantine size scale. Drives row height, font size, cell padding and the
+   * size of the controls in the chrome. `meta.rowHeight` still wins if set.
+   */
+  size?: TMDataGridSize;
+  className?: string;
+  /**
+   * Inline styles. Widened to accept CSS variables, which is how the grid's
+   * colours are themed — `--dg-row-selected-bg` for the selected row
+   * background. Plain `CSSProperties` rejects `--*` keys.
+   */
+  style?: CSSProperties & Record<`--${string}`, string | number>;
 };
 /**
  * Root of the grid. Takes the object returned by `useTMDataGrid` — spread it —
@@ -497,34 +832,54 @@ type TMDataGridProps<TData extends RowData> = TMDataGridApi<TData> & {
  * </TMDataGrid>
  * ```
  */
-declare function TMDataGridRoot<TData extends RowData>({ table, ui, features, size, children, className, style, }: TMDataGridProps<TData>): react.JSX.Element;
+declare function TMDataGridRoot<TData extends RowData>({ table, ui, features, size, children, className, style }: TMDataGridProps<TData>): import("react").JSX.Element;
 declare const TMDataGrid: typeof TMDataGridRoot & {
-    Toolbar: typeof TMDataGridToolbar;
-    Spacer: typeof TMDataGridToolbarSpacer;
-    SummaryCount: typeof TMDataGridSummaryCount;
-    ColumnsButton: typeof TMDataGridColumnsButton;
-    FilterButton: typeof TMDataGridFilterButton;
-    Table: typeof TMDataGridTable;
-    Footer: typeof TMDataGridFooter;
-    /** Rendered by `TMDataGrid.Table`; exported for custom layouts. */
-    FilterPanel: typeof TMDataGridFilterPanel;
-    /** Rendered by `TMDataGrid.ColumnsButton`; exported for custom layouts. */
-    ColumnsPanel: typeof TMDataGridColumnsPanel;
+  Toolbar: typeof TMDataGridToolbar;
+  Spacer: typeof TMDataGridToolbarSpacer;
+  SummaryCount: typeof TMDataGridSummaryCount;
+  ColumnsButton: typeof TMDataGridColumnsButton;
+  FilterButton: typeof TMDataGridFilterButton;
+  Table: typeof TMDataGridTable$1;
+  Footer: typeof TMDataGridFooter;
+  /** Rendered by `TMDataGrid.Table`; exported for custom layouts. */
+  FilterPanel: typeof TMDataGridFilterPanel;
+  /**
+   * Takes the grid as an `api` prop rather than from context, so it can be
+   * rendered outside `<TMDataGrid>` — a page header, for instance.
+   */
+  FilterPills: typeof TMDataGridFilterPills;
+  /** Rendered by `TMDataGrid.ColumnsButton`; exported for custom layouts. */
+  ColumnsPanel: typeof TMDataGridColumnsPanel;
 };
-
+//#endregion
+//#region .types-tmp/components/TMDataGridSelectColumn.d.ts
+declare const SELECT_COLUMN_ID = "__select__";
+//#endregion
+//#region .types-tmp/components/TMDataGridGroupColumn.d.ts
+declare const GROUP_COLUMN_ID = "__group__";
+/**
+ * How a grouping value is written into the tree cell.
+ *
+ * Deliberately not the grouped column's own `cell` renderer: that renderer is
+ * written for a data row and is free to reach into `row.original`, which on a
+ * group row is the first leaf's record rather than anything about the group.
+ */
+declare function formatGroupValue(value: unknown): string;
+//#endregion
+//#region .types-tmp/core/columnUtils.d.ts
 /**
  * Structural shape of the column bits the chrome reads. Kept minimal so these
  * helpers work with any `Column`/`Header` instance without dragging generics
  * through every call site.
  */
 type ColumnLike = {
-    id: string;
-    columnDef: {
-        header?: unknown;
-        meta?: TMDataGridColumnMeta;
-    };
-    /** Set on a leaf that sits inside a header group. */
-    parent?: unknown;
+  id: string;
+  columnDef: {
+    header?: unknown;
+    meta?: TMDataGridColumnMeta;
+  };
+  /** Set on a leaf that sits inside a header group. */
+  parent?: unknown;
 };
 /** Menu- and panel-facing column name. */
 declare function getColumnLabel(column: ColumnLike): string;
@@ -538,9 +893,25 @@ declare function getColumnType(column: ColumnLike): TMDataGridColumnType;
  * columns that no longer belong to it.
  */
 declare function isColumnReorderable(column: ColumnLike): boolean;
-
+//#endregion
+//#region .types-tmp/core/grouping.d.ts
+/**
+ * The data rows under a group row, at any depth.
+ *
+ * Not `row.getLeafRows()`, despite the name: that flattens the whole subtree
+ * and keeps the branches, so a group nested two deep reports its sub-groups
+ * alongside the records. Grouping `city` then `name` would have Stockholm
+ * counting four rows and three names as seven, and one tick on it selecting
+ * ids that hold no record.
+ *
+ * A row with no subRows is a data row, which also makes this the identity on an
+ * ungrouped grid.
+ */
+declare function getGroupDataRows<TData extends RowData>(row: Row<TMDataGridFeatures, TData>): Array<Row<TMDataGridFeatures, TData>>;
+//#endregion
+//#region .types-tmp/core/columnOrdering.d.ts
 type GridColumn = Column<TMDataGridFeatures, TMDataGridRowData, unknown>;
-type GridTable = TMDataGridTable$1<TMDataGridRowData>;
+type GridTable = TMDataGridTable<TMDataGridRowData>;
 /**
  * The lane a column renders in.
  *
@@ -554,12 +925,12 @@ type TMDataGridColumnRegion = "left" | "center" | "right";
 type TMDataGridDropSide = "before" | "after";
 declare function getColumnRegion(columnPinning: ColumnPinningState, columnId: string): TMDataGridColumnRegion;
 type MoveColumnArgs = {
-    table: GridTable;
-    /** Column being moved. */
-    columnId: string;
-    /** Column it was dropped on. */
-    targetId: string;
-    side: TMDataGridDropSide;
+  table: GridTable;
+  /** Column being moved. */
+  columnId: string;
+  /** Column it was dropped on. */
+  targetId: string;
+  side: TMDataGridDropSide;
 };
 /**
  * Moves a column next to another one. A no-op when the two are in different
@@ -570,12 +941,12 @@ type MoveColumnArgs = {
  * unpinned. Pinned lanes are read from `columnPinning`, so a move inside one
  * updates that array as well.
  */
-declare function moveColumn({ table, columnId, targetId, side, }: MoveColumnArgs): void;
+declare function moveColumn({ table, columnId, targetId, side }: MoveColumnArgs): void;
 type ColumnStepArgs = {
-    table: GridTable;
-    columnId: string;
-    /** `-1` moves towards the start of the lane, `1` towards its end. */
-    direction: -1 | 1;
+  table: GridTable;
+  columnId: string;
+  /** `-1` moves towards the start of the lane, `1` towards its end. */
+  direction: -1 | 1;
 };
 /**
  * The column a single step would swap with, or `null` when there is none.
@@ -584,9 +955,103 @@ type ColumnStepArgs = {
  * — that is what keeps the checkbox column anchored at the start of the left
  * lane. Use it to enable or disable a "move" control.
  */
-declare function getStepTargetColumn({ table, columnId, direction, }: ColumnStepArgs): GridColumn | null;
+declare function getStepTargetColumn({ table, columnId, direction }: ColumnStepArgs): GridColumn | null;
 /** Moves a column one position within its lane. Hidden columns are stepped over. */
-declare function moveColumnByStep({ table, columnId, direction, }: ColumnStepArgs): void;
-
-export { DATA_STATE_SLICES, DEFAULT_TMDATAGRID_SIZE, FILTER_OPERATOR_LABELS, SELECT_COLUMN_ID, SETTINGS_STATE_SLICES, SIZE_CONTROL_SIZE, SIZE_ROW_HEIGHT, TMDataGrid, createTMDataGridColumnHelper, getColumnCapabilities, getColumnLabel, getColumnRegion, getColumnType, getGridCapabilities, getStepTargetColumn, isColumnReorderable, isFilterActive, moveColumn, moveColumnByStep, openColumnFilter, readFeatureFlags, tmDataGridFeatures, useTMDataGrid, useTMDataGridContext };
-export type { ColumnStepArgs, MoveColumnArgs, TMDataGridApi, TMDataGridCapabilities, TMDataGridColumnCapabilities, TMDataGridColumnLayout, TMDataGridColumnMeta, TMDataGridColumnRegion, TMDataGridColumnType, TMDataGridContextValue, TMDataGridDataSlice, TMDataGridDropSide, TMDataGridFeatureFlags, TMDataGridFeatures, TMDataGridFilterOperator, TMDataGridFilterValue, TMDataGridPersistKey, TMDataGridPersistence, TMDataGridProps, TMDataGridRowData, TMDataGridSettingsSlice, TMDataGridSize, TMDataGridStorageMode, TMDataGridTable$1 as TMDataGridTable, TMDataGridTableMeta, TMDataGridUiActions, TMDataGridUiState, TMDataGridUiStore, UseTMDataGridOptions };
+declare function moveColumnByStep({ table, columnId, direction }: ColumnStepArgs): void;
+//#endregion
+//#region .types-tmp/core/rowSelection.d.ts
+/**
+ * Rows in the order they are displayed, which is the order a shift-click range
+ * is measured over — so a range follows the active sort and skips filtered-out
+ * rows. Under pagination it is the current page, so a range cannot cross a page
+ * boundary.
+ *
+ * Once a column is grouped this includes the group rows, and only the leaves of
+ * groups that are open — and paging is suspended, so it is the whole tree. That
+ * is the right list for a range: it is what the user can see, and a range that
+ * swept collapsed rows would select things off screen. What a group row in the
+ * range contributes is decided by {@link getSelectableRowIds}.
+ */
+declare function getDisplayedRows<TData extends RowData>(table: TMDataGridTable<TData>, features: TMDataGridFeatureFlags): Array<Row<TMDataGridFeatures, TData>>;
+/**
+ * Whether the built-in pager is actually slicing anything.
+ *
+ * Grouping suspends it. A page can only count one kind of thing, and once the
+ * rows are a tree neither answer works: counting every row splits a group
+ * across a page boundary and strands the rest of the tree on pages the user has
+ * to go looking for, and counting only the top-level rows quietly redefines
+ * "rows per page" as groups per page, so a page of 25 can hold thousands of
+ * rows. Rather than pick, the grid renders the whole tree and leans on the
+ * virtualizer — which is its default mode anyway, pagination being opt-in.
+ *
+ * `TMDataGrid.Footer` reads this too, and greys the pager out rather than
+ * hiding it, so the pager going quiet is visible instead of mysterious.
+ */
+declare function isPagingActive<TData extends RowData>(table: TMDataGridTable<TData>, features: TMDataGridFeatureFlags): boolean;
+/**
+ * Which modifiers were held. Named for what they mean rather than for the keys,
+ * because the keys differ per platform — `toggle` is Ctrl on Windows/Linux and
+ * Cmd on macOS.
+ */
+type TMDataGridRowClickModifiers = {
+  toggle: boolean;
+  extend: boolean;
+};
+type ResolveRowSelectionClickArgs<TData extends RowData> = {
+  /** Displayed order — see {@link getDisplayedRows}. */
+  rows: ReadonlyArray<Row<TMDataGridFeatures, TData>>;
+  rowId: string;
+  /** The pivot a shift-click extends from. */
+  anchorRowId: string | null;
+  modifiers: TMDataGridRowClickModifiers;
+  selection: RowSelectionState;
+  /**
+   * 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.
+   */
+  canReplaceSelection: boolean;
+};
+type ResolvedRowSelection = {
+  selection: RowSelectionState;
+  anchorRowId: string | null;
+};
+/**
+ * The row ids one gesture on this row selects.
+ *
+ * A group row is never selected itself: it holds no record, and TanStack
+ * derives its checked state from its descendants. So ticking a group means
+ * ticking every selectable leaf under it, which is also what makes the group's
+ * own box light up.
+ *
+ * Leaves rather than direct children, so one click on a top-level group takes
+ * the whole subtree however deeply it nests.
+ */
+declare function getSelectableRowIds<TData extends RowData>(row: Row<TMDataGridFeatures, TData>): Array<string>;
+/**
+ * Turns one click into the next selection, following the convention every
+ * desktop list uses:
+ *
+ * | Gesture | Effect |
+ * | ------- | ------ |
+ * | Click | selection becomes only this row |
+ * | Ctrl/Cmd + click | toggle this row, leave the rest |
+ * | Shift + click | selection becomes the range anchor → this row |
+ * | Ctrl/Cmd + Shift + click | add that range to the selection |
+ *
+ * The anchor is a *pivot*, not "the last row touched": only a plain or
+ * Ctrl-click moves it, which is what lets a run of shift-clicks grow and shrink
+ * the same range from a fixed point.
+ *
+ * Selection state is rebuilt here and handed to `setRowSelection` wholesale
+ * rather than going through `row.toggleSelected()` per row, which would publish
+ * one state update each. That skips TanStack's sub-row cascade, so the cascade
+ * is done here instead: every row in the gesture is expanded through
+ * {@link getSelectableRowIds} before it reaches the map. Under grouping that is
+ * what makes one tick on a group select all of it.
+ */
+declare function resolveRowSelectionClick<TData extends RowData>({ rows, rowId, anchorRowId, modifiers, selection, canReplaceSelection }: ResolveRowSelectionClickArgs<TData>): ResolvedRowSelection;
+//#endregion
+export { type ColumnStepArgs, DATA_STATE_SLICES, DEFAULT_TMDATAGRID_SIZE, FILTER_OPERATOR_LABELS, GROUP_COLUMN_ID, type MoveColumnArgs, type ResolveRowSelectionClickArgs, type ResolvedRowSelection, SELECT_COLUMN_ID, SETTINGS_STATE_SLICES, SIZE_CONTROL_SIZE, SIZE_ROW_HEIGHT, TMDataGrid, type TMDataGridApi, type TMDataGridCapabilities, type TMDataGridColumnCapabilities, type TMDataGridColumnLayout, type TMDataGridColumnMeta, type TMDataGridColumnRegion, type TMDataGridColumnType, type TMDataGridContextValue, type TMDataGridDataSlice, type TMDataGridDropSide, type TMDataGridFeatureFlags, type TMDataGridFeatures, type TMDataGridFilterOperator, TMDataGridFilterPills, type TMDataGridFilterPillsProps, type TMDataGridFilterValue, type TMDataGridFooterProps, type TMDataGridPaginationApi, type TMDataGridPersistKey, type TMDataGridPersistence, type TMDataGridProps, type TMDataGridRowClickModifiers, type TMDataGridRowContextMenu, type TMDataGridRowContextMenuArgs, type TMDataGridRowData, type TMDataGridSelectionMode, type TMDataGridSettingsSlice, type TMDataGridSize, type TMDataGridStorageMode, type TMDataGridTable, type TMDataGridTableMeta, type TMDataGridTableProps, type TMDataGridUiActions, type TMDataGridUiState, type TMDataGridUiStore, type UseTMDataGridOptions, createTMDataGridColumnHelper, formatFilterLabel, formatGroupValue, getColumnCapabilities, getColumnLabel, getColumnRegion, getColumnType, getDisplayedRows, getGridCapabilities, getGroupDataRows, getSelectableRowIds, getStepTargetColumn, getTMDataGridPaginationApi, isColumnReorderable, isFilterActive, isPagingActive, moveColumn, moveColumnByStep, openColumnFilter, readFeatureFlags, resolveRowSelectionClick, tmDataGridFeatures, useTMDataGrid, useTMDataGridContext };