@jielga/tmdatagrid 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,49 +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 { Column, ColumnPinningState, Row, RowData, Table, TableFeatures, TableOptions, TableState } from "@tanstack/react-table";
+import { CSSProperties, ReactNode } from "react";
+import { Store } from "@tanstack/store";
+import { MantineSize } from "@mantine/core";
+//#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;
-
-type TMDataGridSize = MantineSize;
-declare const DEFAULT_TMDATAGRID_SIZE: TMDataGridSize;
-/**
- * Row height per size, in px.
- *
- * The virtualizer needs this as a number — it cannot read the CSS variable —
- * so the scale lives here and `TMDataGrid.module.css` mirrors it. `meta.rowHeight`
- * overrides it when a grid needs a height the scale doesn't offer.
- */
-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>;
-
+declare function TMDataGridFilterPanel(): import("react").JSX.Element | null;
+//#endregion
+//#region .types-tmp/core/filterOperators.d.ts
 /**
  * The value shape stored in `columnFilters` for every TMDataGrid column.
  *
@@ -53,8 +29,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";
@@ -71,7 +47,8 @@ declare function isFilterActive(value: unknown): boolean;
  * "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`.
@@ -110,18 +87,49 @@ 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/core/sizes.d.ts
+type TMDataGridSize = MantineSize;
+declare const DEFAULT_TMDATAGRID_SIZE: TMDataGridSize;
+/**
+ * Row height per size, in px.
+ *
+ * The virtualizer needs this as a number — it cannot read the CSS variable —
+ * so the scale lives here and `TMDataGrid.module.css` mirrors it. `meta.rowHeight`
+ * overrides it when a grid needs a height the scale doesn't offer.
+ */
+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/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 +142,30 @@ type TMDataGridPersistence = {
  * TanStack still decides: these flags are combined with `getCanX()`, which is
  * what applies the per-column overrides.
  */
+/**
+ * How rows are selected — see `rowSelectionMode` on {@link UseTMDataGridOptions}.
+ */
+type TMDataGridRowSelectionMode = "checkbox" | "row";
 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;
+  rowSelection: boolean;
+  /** Only meaningful while `rowSelection` is on. Defaults to `"checkbox"`. */
+  rowSelectionMode: TMDataGridRowSelectionMode;
+  /** Whether a selected row takes the highlight colour. Follows the mode. */
+  highlightSelectedRows: 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;
 };
-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" | "rowSelectionMode" | "highlightSelectedRows" | "enablePagination" | "manualPagination">): TMDataGridFeatureFlags;
 /**
  * What one column's header may offer.
  *
@@ -157,193 +179,194 @@ declare function readFeatureFlags<TData extends RowData>(options: Pick<UseTMData
  * | Header dragging, Move left / right | `enableColumnOrdering` / `meta.enableOrdering` |
  */
 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;
 };
 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;
+  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;
+  filteredRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  sortedRowModel: (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;
+    };
+    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;
+    };
+    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;
     };
-    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;
+    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;
     };
-    tableMeta: TMDataGridTableMeta;
-    columnMeta: TMDataGridColumnMeta;
+    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;
+  };
+  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;
+  filteredRowModel: (table: Table<any, any>) => () => import("@tanstack/table-core").RowModel<any, any>;
+  sortedRowModel: (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;
+    };
+    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;
+    };
+    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;
     };
-    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;
+    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;
     };
-    tableMeta: TMDataGridTableMeta;
-    columnMeta: TMDataGridColumnMeta;
+    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;
+  };
+  tableMeta: TMDataGridTableMeta;
+  columnMeta: TMDataGridColumnMeta;
 }, TData>;
 /**
  * Chrome state that is *not* table state: which panels are open, and which
@@ -351,50 +374,88 @@ 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;
 };
 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;
 };
 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"`.
+   *
+   * - `"checkbox"` — the generated checkbox column selects; clicking a row
+   *   elsewhere does not.
+   * - `"row"` — no checkbox column; clicking a row toggles it. Other rows keep
+   *   their state, so a click never clears the rest of the selection.
+   *
+   * Ignored when `enableRowSelection` is `false`. Both modes write to the same
+   * `rowSelection` state.
+   */
+  rowSelectionMode?: TMDataGridRowSelectionMode;
+  /**
+   * Give selected rows the highlight background. Defaults to `true` under
+   * `rowSelectionMode: "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)" }}
+   * />
+   * ```
+   */
+  highlightSelectedRows?: boolean;
 };
 /**
  * Builds a TMDataGrid table plus its chrome store.
@@ -403,81 +464,121 @@ 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, rowSelectionMode, highlightSelectedRows, ...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/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;
+};
 /**
- * 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.
+ * 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.
  */
-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 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;
 };
-declare function useTMDataGridContext(): TMDataGridContextValue;
-
+/**
+ * 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;
 };
 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
+   * `rowSelectionMode: "row"`, not instead of it.
+   */
+  onRowClick?: (row: Row<TMDataGridFeatures, TData>) => void;
 };
 /**
  * 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 }: 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 +598,38 @@ 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;
+  /** 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/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 +643,10 @@ declare function getColumnType(column: ColumnLike): TMDataGridColumnType;
  * columns that no longer belong to it.
  */
 declare function isColumnReorderable(column: ColumnLike): boolean;
-
+//#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 +660,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 +676,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 +690,8 @@ 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
+export { type ColumnStepArgs, DATA_STATE_SLICES, DEFAULT_TMDATAGRID_SIZE, FILTER_OPERATOR_LABELS, type MoveColumnArgs, 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, type TMDataGridFilterValue, type TMDataGridFooterProps, type TMDataGridPaginationApi, type TMDataGridPersistKey, type TMDataGridPersistence, type TMDataGridProps, type TMDataGridRowData, type TMDataGridRowSelectionMode, type TMDataGridSettingsSlice, type TMDataGridSize, type TMDataGridStorageMode, type TMDataGridTable, type TMDataGridTableMeta, type TMDataGridUiActions, type TMDataGridUiState, type TMDataGridUiStore, type UseTMDataGridOptions, createTMDataGridColumnHelper, getColumnCapabilities, getColumnLabel, getColumnRegion, getColumnType, getGridCapabilities, getStepTargetColumn, getTMDataGridPaginationApi, isColumnReorderable, isFilterActive, moveColumn, moveColumnByStep, openColumnFilter, readFeatureFlags, tmDataGridFeatures, useTMDataGrid, useTMDataGridContext };