@kanunilabs/datagrid-react 1.4.0 → 1.6.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { GridRowData, DataGridController, StateStoringConfig, RowKey, RowNode, GridColumnDef, DataGridCoreConfig, InferColumnsOptions, GridThemeName, GridPalette, DescribeFilterOptions, GridDensity, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, SummaryDef, FilterNode, ColumnState, BusyPhase, GridDictionary, DataRowNode, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel } from '@kanunilabs/datagrid-core';
-export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_PALETTES, GRID_THEMES, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, StateStoringConfig, RowKey, RowNode, GridColumnDef, DataGridCoreConfig, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, DataRowNode, ColSpanPlan, SummaryDef, FilterNode, ColumnState, BusyPhase, GridDictionary, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel } from '@kanunilabs/datagrid-core';
+export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
 type ExportKind = 'csv' | 'excel' | 'excel-selected' | 'pdf';
@@ -221,6 +221,14 @@ interface ReactGridColumnDef<TRow = GridRowData> extends GridColumnDef<TRow> {
      * `tooltip` wins if both are given.
      */
     tooltipField?: string;
+    /**
+     * Rich tooltip content for this column's cells (P-TOOL-01): an image, a
+     * small table, a link — anything React can draw. Wins over `tooltip` and
+     * `tooltipField`; return null to show no tooltip for that cell. Runs only for
+     * the cell the tooltip is about. Pair it with `tooltip.interactive` when the
+     * content holds something to click.
+     */
+    renderTooltip?: (ctx: CellRenderContext<TRow>) => ReactNode;
     /** Tooltip for this column's HEADER cell. */
     headerTooltip?: string;
 }
@@ -318,6 +326,20 @@ interface GridTooltipConfig {
      * the behaviour the column API exists to override, not the other way round.
      */
     showOnTruncation?: boolean;
+    /**
+     * What opens a cell's tooltip (P-TOOL-01). `'hover'` (default): the mouse
+     * resting on it. `'focus'`: the cell taking keyboard focus — arrowing onto
+     * it, or tapping it on a touch screen, where there is no hover. `'both'`.
+     * A focus tooltip is tied to its cell with `aria-describedby`, so a screen
+     * reader reads it with the cell; Escape closes it.
+     */
+    trigger?: 'hover' | 'focus' | 'both';
+    /**
+     * Let the pointer move onto the tooltip (P-TOOL-01): it stays open while the
+     * pointer is on it, so its text can be selected and a link in it clicked.
+     * Default false — a tooltip that steps out of the way of the pointer.
+     */
+    interactive?: boolean;
 }
 type ReactColumnRuntime<TRow = GridRowData> = Omit<ColumnRuntime<TRow>, 'def'> & {
     def: ReactGridColumnDef<TRow>;
@@ -392,7 +414,7 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
     /** Applies the packaged dark palette. */
     dark?: boolean;
     /**
-     * A packaged look — `'quartz'`, `'balham'`, `'material'`, `'alpine'`,
+     * A packaged look — `'minimal'`, `'ledger'`, `'elevated'`, `'framed'`,
      * `'kanuni'` or `'kanuni-midnight'`. Omit for the default palette, which is
      * unchanged and always will be.
      *
@@ -417,12 +439,17 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * `'nord'`, `'dracula'`, `'solarized'`, `'gruvbox'`, `'catppuccin'` or
      * `'tokyo-night'`.
      *
-     * Independent of `theme`, so the two multiply: Balham's dense ruled grid in
-     * Nord's blues, or Material's tall one in the same blues. Works with `dark`
+     * Independent of `theme`, so the two multiply: Ledger's dense ruled grid in
+     * Nord's blues, or Elevated's tall one in the same blues. Works with `dark`
      * (each palette ships both), and without a `theme` it recolours the packaged
      * default. Omit it and the theme's own colours apply.
+     *
+     * Also one of the 36 packaged colour schemes (`GRID_COLOR_SCHEMES` —
+     * `'porcelain'`, `'graphite'`…; each light OR dark, whatever `dark` says),
+     * with its stylesheet `@kanunilabs/datagrid-react/themes/<id>.css` imported
+     * after `styles.css`; or the name of your own scheme from the Theme Builder.
      */
-    palette?: GridPalette;
+    palette?: GridPaletteName;
     /** Alternating row background. */
     striped?: boolean;
     /** Shown when the pipeline yields no rows. */
@@ -728,6 +755,15 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
     onCellPointerDown?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
+    /**
+     * A click on a column header, asked before it sorts; return true to take it
+     * (the header then does not sort). Column selection uses it (G-SEL-02).
+     */
+    onHeaderClick?: (columnId: string, event: React.MouseEvent) => boolean;
+    /** Extra class names per header cell. Must be a fresh function when the answer changes. */
+    getHeaderClassName?: (columnId: string) => string | undefined;
+    /** Replace a header's label (a rename box). Undefined = the label. Fresh when the answer changes. */
+    renderHeaderLabel?: (columnId: string) => ReactNode | undefined;
     /**
      * Unlocks the Enterprise edition. **Set by `EnterpriseDataGrid`** — an app
      * rendering `DataGrid` directly leaves it off.
@@ -804,6 +840,8 @@ interface GridHeaderProps<TRow = GridRowData> {
     rowNumberHeader?: React.ReactNode;
     /** 'all' | 'some' | 'none' — drives the tri-state select-all box. */
     selectAllState?: 'all' | 'some' | 'none';
+    /** No row in the result can be selected (`selection.isRowSelectable`). */
+    selectAllDisabled?: boolean;
     onToggleSelectAll?: () => void;
     /** Make headers draggable onto the group panel. */
     draggable?: boolean;
@@ -829,8 +867,22 @@ interface GridHeaderProps<TRow = GridRowData> {
     onAutoFit?: (columnId: string) => void;
     /** Right-click on a header cell (Enterprise header menu). */
     onHeaderContextMenu?: (columnId: string, event: React.MouseEvent) => void;
+    /**
+     * The grouping levels: the group column (`grouping.display: 'column'`)
+     * shows the direction of the first one, since its click sorts them all.
+     */
+    groupLevels?: readonly string[];
+    /**
+     * A click on a header cell, asked BEFORE it sorts. True means the click was
+     * taken (Enterprise column selection, G-SEL-02) and the header does not sort.
+     */
+    onHeaderClick?: (columnId: string, event: React.MouseEvent) => boolean;
+    /** Extra class names per header cell (a selected column). */
+    getHeaderClassName?: (columnId: string) => string | undefined;
+    /** Replace a header's label (the Enterprise rename box, G-CORE-06). Undefined = the label. */
+    renderHeaderLabel?: (columnId: string) => React.ReactNode | undefined;
 }
-declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, rowNumberColumn, rowNumberHeader, selectAllState, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, }: GridHeaderProps<TRow>): react.JSX.Element;
+declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, rowNumberColumn, rowNumberHeader, selectAllState, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, onHeaderClick, getHeaderClassName, renderHeaderLabel, }: GridHeaderProps<TRow>): react.JSX.Element;
 declare const GridHeader: typeof GridHeaderImpl;
 
 /**
@@ -900,6 +952,18 @@ interface GridRowProps<TRow = GridRowData> {
     trailingSpacer: number;
     striped: boolean;
     selected: boolean;
+    /**
+     * Whether the row tells a screen reader its selection state
+     * (`aria-selected`). Off where rows cannot be selected — a grid without
+     * selection, a pinned row — so the reader does not say "not selected" on
+     * every one. Default true.
+     */
+    ariaSelectable?: boolean;
+    /**
+     * False when `selection.isRowSelectable` refuses this row: its checkbox is
+     * drawn disabled. Default true.
+     */
+    selectable?: boolean;
     /**
      * A group header's checkbox state — its rows all, some or none selected.
      * Absent: no checkbox (single selection, or no checkbox column).
@@ -911,7 +975,7 @@ interface GridRowProps<TRow = GridRowData> {
      * `grouping.display`: `'aligned'` draws a group row as cells, its name in
      * the first visible column and each summary under its own column.
      */
-    groupDisplay?: 'fullWidth' | 'aligned';
+    groupDisplay?: 'fullWidth' | 'aligned' | 'column';
     /** Column id holding keyboard focus in this row, or null. */
     focusedColumnId: string | null;
     /** Highlight this row as the focused one (`focusedRow` is on). */
@@ -966,6 +1030,20 @@ interface GridRowProps<TRow = GridRowData> {
     } | {
         kind: 'covered';
     } | null;
+    /**
+     * How this data row's cells span columns (G-CORE-03), or null. Resolved by
+     * the caller — the plan needs the column window — through ONE stable
+     * function for the same reason as `getSpan`: a closure per row would defeat
+     * the memo.
+     */
+    resolveColSpans?: (node: DataRowNode<TRow>) => ColSpanPlan<TRow> | null;
+    /**
+     * Find without filtering (P-FIND-01): how a cell takes part — the current
+     * match, another match, or not at all. `findStamp` changes whenever the
+     * marks do, so the memoised row redraws.
+     */
+    findKind?: (rowKey: RowKey, columnId: string) => 'active' | 'match' | null;
+    findStamp?: string;
     /**
      * The number to show, already resolved (see `rowNumberAt` in geometry).
      *
@@ -1046,7 +1124,7 @@ interface GridRowProps<TRow = GridRowData> {
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
 }
-declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, rowNumberColumn, rowNumber, getNote, getSpan, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, height, }: GridRowProps<TRow>): react.JSX.Element | null;
+declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, height, }: GridRowProps<TRow>): react.JSX.Element | null;
 declare const GridRow: typeof GridRowImpl;
 
 interface GridFilterRowProps<TRow = GridRowData> {
@@ -1389,7 +1467,7 @@ interface GridPagerProps {
     pageSizes?: number[];
     /** Rows after filtering (the thing being paged through). */
     totalRows: number;
-    /** Absolute jump (first/last). */
+    /** Absolute jump (first/last, and a numbered page button). */
     onPage: (page: number) => void;
     /**
      * RELATIVE moves go through their own callbacks so they read the controller's
@@ -1400,9 +1478,22 @@ interface GridPagerProps {
     onNext: () => void;
     onPrevious: () => void;
     onPageSize: (size: number) => void;
-    labels?: Partial<Record<'first' | 'previous' | 'next' | 'last' | 'page' | 'of' | 'rowsPerPage', string>>;
+    /**
+     * Numbered page buttons — `1 2 3 … 40` — in place of "Page 3 of 40"
+     * (`pagination.pageButtons`). The current page's button carries
+     * `aria-current="page"`.
+     */
+    pageButtons?: boolean;
+    /** Most slots the numbered buttons take, ellipses included. Default 7, at least 5. */
+    maxPageButtons?: number;
+    /**
+     * Overrides for the pager's words. `pageButton` is a numbered button's
+     * accessible name, with `{n}` for the page; `navigation` names the pager
+     * itself.
+     */
+    labels?: Partial<Record<'first' | 'previous' | 'next' | 'last' | 'page' | 'of' | 'rowsPerPage' | 'pageButton' | 'navigation', string>>;
 }
-declare function GridPagerImpl({ page, pageCount, pageSize, pageSizes, totalRows, onPage, onNext, onPrevious, onPageSize, labels, }: GridPagerProps): react.JSX.Element;
+declare function GridPagerImpl({ page, pageCount, pageSize, pageSizes, totalRows, onPage, onNext, onPrevious, onPageSize, pageButtons, maxPageButtons, labels, }: GridPagerProps): react.JSX.Element;
 declare const GridPager: react.MemoExoticComponent<typeof GridPagerImpl>;
 
 /** Labels, so the menu can be localized without rebuilding the item list. */
@@ -1504,6 +1595,8 @@ declare function useAlignedGrids<TRow = GridRowData>(controller: DataGridControl
 /** What the tooltip should say and where it should point. */
 interface TooltipState {
     text: string;
+    /** Rich content from a column's `renderTooltip` (P-TOOL-01); drawn instead of `text`. */
+    content?: ReactNode;
     /** Viewport rectangle of the element being described. */
     anchor: {
         top: number;
@@ -1511,6 +1604,14 @@ interface TooltipState {
         width: number;
         height: number;
     };
+    /** `tooltip.interactive`: the pointer may move onto it (P-TOOL-01). */
+    interactive?: boolean;
+    /** The pointer reached the tooltip — keep it open. */
+    hold?: () => void;
+    /** The pointer left the tooltip — close it. */
+    release?: () => void;
+    /** The tooltip element's id, which the described cell points at with `aria-describedby`. */
+    id?: string;
 }
 interface CellTooltipOptions<TRow = GridRowData> {
     rootRef: RefObject<HTMLElement | null>;
@@ -1527,8 +1628,14 @@ interface CellTooltipOptions<TRow = GridRowData> {
      */
     getRowNode: (rawKey: string) => DataRowNode<TRow> | undefined;
     config?: GridTooltipConfig;
+    /**
+     * The grid's controller and id — needed for `trigger: 'focus'` (P-TOOL-01),
+     * which follows the focused cell and finds it by the id the row gives it.
+     */
+    controller?: DataGridController<TRow>;
+    gridId?: string;
 }
-declare function useCellTooltip<TRow = GridRowData>({ rootRef, columnModel, getRowNode, getNote, config, }: CellTooltipOptions<TRow>): TooltipState | null;
+declare function useCellTooltip<TRow = GridRowData>({ rootRef, columnModel, getRowNode, getNote, config, controller, gridId, }: CellTooltipOptions<TRow>): TooltipState | null;
 
 interface GridTooltipProps {
     state: TooltipState;
@@ -1541,6 +1648,12 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
     /** Which edge — decides the sticky side and the border. */
     side: 'top' | 'bottom';
     rows: readonly TRow[];
+    /**
+     * Parallel to `rows`: null for a row the app passed, the data row's key for
+     * one the USER pinned (G-CORE-05) — only those open the pin menu.
+     */
+    rowKeys?: readonly (RowKey | null)[];
+    onUserRowContextMenu?: (key: RowKey, row: TRow, event: React.MouseEvent) => void;
     layout: ColumnLayout<TRow>;
     columnModel: ColumnModel<TRow>;
     centerColumns: ReactColumnRuntime<TRow>[];
@@ -1575,7 +1688,7 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
      */
     ariaRowBase: number;
 }
-declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
+declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, rowKeys, onUserRowContextMenu, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
 declare const GridPinnedRows: typeof GridPinnedRowsImpl;
 
 type UseDataGridOptions<TRow = GridRowData> = DataGridCoreConfig<TRow>;
@@ -1649,7 +1762,7 @@ declare function buildCellMenuItems<TRow = GridRowData>(controller: DataGridCont
 interface GridSurfaceProviderProps {
     theme?: GridThemeName;
     density?: GridDensity;
-    palette?: GridPalette;
+    palette?: GridPaletteName;
     children: ReactNode;
 }
 declare function GridSurfaceProvider({ theme, density, palette, children, }: GridSurfaceProviderProps): react.JSX.Element;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { GridRowData, DataGridController, StateStoringConfig, RowKey, RowNode, GridColumnDef, DataGridCoreConfig, InferColumnsOptions, GridThemeName, GridPalette, DescribeFilterOptions, GridDensity, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, SummaryDef, FilterNode, ColumnState, BusyPhase, GridDictionary, DataRowNode, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel } from '@kanunilabs/datagrid-core';
-export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_PALETTES, GRID_THEMES, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
+import { GridRowData, DataGridController, StateStoringConfig, RowKey, RowNode, GridColumnDef, DataGridCoreConfig, InferColumnsOptions, GridThemeName, GridPaletteName, DescribeFilterOptions, GridDensity, ColumnRuntime, ColumnLayout, SortDescriptor, ColumnModel, DataRowNode, ColSpanPlan, SummaryDef, FilterNode, ColumnState, BusyPhase, GridDictionary, VirtualWindow, ChartBoxSpec, ChartBoxModel, ChartSpec, ChartModel, ChartXYSpec, ChartXYModel } from '@kanunilabs/datagrid-core';
+export { BusyChangedEvent, BusyPhase, ClientRowModel, ColumnLayout, ColumnLookup, ColumnModel, ColumnPin, ColumnRuntime, ColumnState, ColumnStateChangedEvent, ContentReadyEvent, DEFAULT_ROW_HEIGHT, DENSITY_ROW_HEIGHT, DataGridController, DataGridCoreConfig, DataRowNode, DataSource, FilterChangedEvent, FilterCondition, FilterGroupNode, FilterNode, FilterOperator, FocusedRowChangedEvent, GRID_COLOR_SCHEMES, GRID_PALETTES, GRID_THEMES, GridColorScheme, GridColumnDef, GridDataType, GridDensity, GridEventMap, GridPalette, GridPaletteName, GridRowData, GridStateStore, GridTheme, GridThemeName, GridViewState, GroupRowNode, GroupingConfig, HeaderBandCell, InferColumnsOptions, LoadOptions, LoadResult, LookupItem, NewRowPosition, RowDropPosition, RowKey, RowNode, SUMMARY_TYPE_LABEL, ScrollingConfig, SelectionDescriptor, SortChangedEvent, SortDescriptor, SortDirection, StateStoringConfig, SummaryDef, SummaryType, THEME_ROW_HEIGHT, ViewportChangedEvent, VirtualWindow, VirtualWindowEngine, allowedSummaryTypes, andFilters, attachStateStoring, bandDepth, bandPath, computeColumnLayout, computeHeaderBands, createRestDataSource, describeFilter, downloadBlob, fillText, filterInputFromNode, formatSummaryValue, humanizeField, importCsv, inferColumns, isDataRow, isDataSource, isFilterGroup, isGroupRow, isPackagedTheme, lookupLabel, moveRowInArray, parseCsv, parseFilterInput, sniffDelimiter, summaryKey, summaryLabel, summaryTypeLabels, themeClassName } from '@kanunilabs/datagrid-core';
 
 /** Formats an export menu can offer. */
 type ExportKind = 'csv' | 'excel' | 'excel-selected' | 'pdf';
@@ -221,6 +221,14 @@ interface ReactGridColumnDef<TRow = GridRowData> extends GridColumnDef<TRow> {
      * `tooltip` wins if both are given.
      */
     tooltipField?: string;
+    /**
+     * Rich tooltip content for this column's cells (P-TOOL-01): an image, a
+     * small table, a link — anything React can draw. Wins over `tooltip` and
+     * `tooltipField`; return null to show no tooltip for that cell. Runs only for
+     * the cell the tooltip is about. Pair it with `tooltip.interactive` when the
+     * content holds something to click.
+     */
+    renderTooltip?: (ctx: CellRenderContext<TRow>) => ReactNode;
     /** Tooltip for this column's HEADER cell. */
     headerTooltip?: string;
 }
@@ -318,6 +326,20 @@ interface GridTooltipConfig {
      * the behaviour the column API exists to override, not the other way round.
      */
     showOnTruncation?: boolean;
+    /**
+     * What opens a cell's tooltip (P-TOOL-01). `'hover'` (default): the mouse
+     * resting on it. `'focus'`: the cell taking keyboard focus — arrowing onto
+     * it, or tapping it on a touch screen, where there is no hover. `'both'`.
+     * A focus tooltip is tied to its cell with `aria-describedby`, so a screen
+     * reader reads it with the cell; Escape closes it.
+     */
+    trigger?: 'hover' | 'focus' | 'both';
+    /**
+     * Let the pointer move onto the tooltip (P-TOOL-01): it stays open while the
+     * pointer is on it, so its text can be selected and a link in it clicked.
+     * Default false — a tooltip that steps out of the way of the pointer.
+     */
+    interactive?: boolean;
 }
 type ReactColumnRuntime<TRow = GridRowData> = Omit<ColumnRuntime<TRow>, 'def'> & {
     def: ReactGridColumnDef<TRow>;
@@ -392,7 +414,7 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
     /** Applies the packaged dark palette. */
     dark?: boolean;
     /**
-     * A packaged look — `'quartz'`, `'balham'`, `'material'`, `'alpine'`,
+     * A packaged look — `'minimal'`, `'ledger'`, `'elevated'`, `'framed'`,
      * `'kanuni'` or `'kanuni-midnight'`. Omit for the default palette, which is
      * unchanged and always will be.
      *
@@ -417,12 +439,17 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
      * `'nord'`, `'dracula'`, `'solarized'`, `'gruvbox'`, `'catppuccin'` or
      * `'tokyo-night'`.
      *
-     * Independent of `theme`, so the two multiply: Balham's dense ruled grid in
-     * Nord's blues, or Material's tall one in the same blues. Works with `dark`
+     * Independent of `theme`, so the two multiply: Ledger's dense ruled grid in
+     * Nord's blues, or Elevated's tall one in the same blues. Works with `dark`
      * (each palette ships both), and without a `theme` it recolours the packaged
      * default. Omit it and the theme's own colours apply.
+     *
+     * Also one of the 36 packaged colour schemes (`GRID_COLOR_SCHEMES` —
+     * `'porcelain'`, `'graphite'`…; each light OR dark, whatever `dark` says),
+     * with its stylesheet `@kanunilabs/datagrid-react/themes/<id>.css` imported
+     * after `styles.css`; or the name of your own scheme from the Theme Builder.
      */
-    palette?: GridPalette;
+    palette?: GridPaletteName;
     /** Alternating row background. */
     striped?: boolean;
     /** Shown when the pipeline yields no rows. */
@@ -728,6 +755,15 @@ interface DataGridProps<TRow = GridRowData> extends Omit<DataGridCoreConfig<TRow
     onCellPointerDown?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
+    /**
+     * A click on a column header, asked before it sorts; return true to take it
+     * (the header then does not sort). Column selection uses it (G-SEL-02).
+     */
+    onHeaderClick?: (columnId: string, event: React.MouseEvent) => boolean;
+    /** Extra class names per header cell. Must be a fresh function when the answer changes. */
+    getHeaderClassName?: (columnId: string) => string | undefined;
+    /** Replace a header's label (a rename box). Undefined = the label. Fresh when the answer changes. */
+    renderHeaderLabel?: (columnId: string) => ReactNode | undefined;
     /**
      * Unlocks the Enterprise edition. **Set by `EnterpriseDataGrid`** — an app
      * rendering `DataGrid` directly leaves it off.
@@ -804,6 +840,8 @@ interface GridHeaderProps<TRow = GridRowData> {
     rowNumberHeader?: React.ReactNode;
     /** 'all' | 'some' | 'none' — drives the tri-state select-all box. */
     selectAllState?: 'all' | 'some' | 'none';
+    /** No row in the result can be selected (`selection.isRowSelectable`). */
+    selectAllDisabled?: boolean;
     onToggleSelectAll?: () => void;
     /** Make headers draggable onto the group panel. */
     draggable?: boolean;
@@ -829,8 +867,22 @@ interface GridHeaderProps<TRow = GridRowData> {
     onAutoFit?: (columnId: string) => void;
     /** Right-click on a header cell (Enterprise header menu). */
     onHeaderContextMenu?: (columnId: string, event: React.MouseEvent) => void;
+    /**
+     * The grouping levels: the group column (`grouping.display: 'column'`)
+     * shows the direction of the first one, since its click sorts them all.
+     */
+    groupLevels?: readonly string[];
+    /**
+     * A click on a header cell, asked BEFORE it sorts. True means the click was
+     * taken (Enterprise column selection, G-SEL-02) and the header does not sort.
+     */
+    onHeaderClick?: (columnId: string, event: React.MouseEvent) => boolean;
+    /** Extra class names per header cell (a selected column). */
+    getHeaderClassName?: (columnId: string) => string | undefined;
+    /** Replace a header's label (the Enterprise rename box, G-CORE-06). Undefined = the label. */
+    renderHeaderLabel?: (columnId: string) => React.ReactNode | undefined;
 }
-declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, rowNumberColumn, rowNumberHeader, selectAllState, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, }: GridHeaderProps<TRow>): react.JSX.Element;
+declare function GridHeaderImpl<TRow = GridRowData>({ bandOffset, stickyInsets, layout, centerColumns, leadingSpacer, trailingSpacer, sort, sortable, onSort, headerFilter, filteredColumns, onOpenFilter, filterIconMode, checkboxColumn, detailColumn, rowNumberColumn, rowNumberHeader, selectAllState, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, onHeaderClick, getHeaderClassName, renderHeaderLabel, }: GridHeaderProps<TRow>): react.JSX.Element;
 declare const GridHeader: typeof GridHeaderImpl;
 
 /**
@@ -900,6 +952,18 @@ interface GridRowProps<TRow = GridRowData> {
     trailingSpacer: number;
     striped: boolean;
     selected: boolean;
+    /**
+     * Whether the row tells a screen reader its selection state
+     * (`aria-selected`). Off where rows cannot be selected — a grid without
+     * selection, a pinned row — so the reader does not say "not selected" on
+     * every one. Default true.
+     */
+    ariaSelectable?: boolean;
+    /**
+     * False when `selection.isRowSelectable` refuses this row: its checkbox is
+     * drawn disabled. Default true.
+     */
+    selectable?: boolean;
     /**
      * A group header's checkbox state — its rows all, some or none selected.
      * Absent: no checkbox (single selection, or no checkbox column).
@@ -911,7 +975,7 @@ interface GridRowProps<TRow = GridRowData> {
      * `grouping.display`: `'aligned'` draws a group row as cells, its name in
      * the first visible column and each summary under its own column.
      */
-    groupDisplay?: 'fullWidth' | 'aligned';
+    groupDisplay?: 'fullWidth' | 'aligned' | 'column';
     /** Column id holding keyboard focus in this row, or null. */
     focusedColumnId: string | null;
     /** Highlight this row as the focused one (`focusedRow` is on). */
@@ -966,6 +1030,20 @@ interface GridRowProps<TRow = GridRowData> {
     } | {
         kind: 'covered';
     } | null;
+    /**
+     * How this data row's cells span columns (G-CORE-03), or null. Resolved by
+     * the caller — the plan needs the column window — through ONE stable
+     * function for the same reason as `getSpan`: a closure per row would defeat
+     * the memo.
+     */
+    resolveColSpans?: (node: DataRowNode<TRow>) => ColSpanPlan<TRow> | null;
+    /**
+     * Find without filtering (P-FIND-01): how a cell takes part — the current
+     * match, another match, or not at all. `findStamp` changes whenever the
+     * marks do, so the memoised row redraws.
+     */
+    findKind?: (rowKey: RowKey, columnId: string) => 'active' | 'match' | null;
+    findStamp?: string;
     /**
      * The number to show, already resolved (see `rowNumberAt` in geometry).
      *
@@ -1046,7 +1124,7 @@ interface GridRowProps<TRow = GridRowData> {
     onCellPointerEnter?: (ctx: CellSlotContext<TRow>, event: React.MouseEvent) => void;
     onCellDoubleClick?: (ctx: CellSlotContext<TRow>) => void;
 }
-declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, rowNumberColumn, rowNumber, getNote, getSpan, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, height, }: GridRowProps<TRow>): react.JSX.Element | null;
+declare function GridRowImpl<TRow = GridRowData>({ gridId, node, index, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, striped, selected, ariaSelectable, selectable, groupSelection, onToggleGroupSelect, groupDisplay, focusedColumnId, rowFocused, renderRow, checkboxColumn, rowNumberColumn, rowNumber, getNote, getSpan, resolveColSpans, findKind, headerRowCount, onRowClick, onRowMouseDown, onRowDoubleClick, onToggleSelect, onCellMouseDown, onRowContextMenu, searchNeedle, onToggleGroup, summaryDefs, detailColumn, detailExpanded, onToggleDetail, onToggleTreeRow, renderDetail, renderEditForm, renderCellContent, getCellClassName, onCellPointerDown, onCellPointerEnter, onCellDoubleClick, rowDrag, dropSide, height, }: GridRowProps<TRow>): react.JSX.Element | null;
 declare const GridRow: typeof GridRowImpl;
 
 interface GridFilterRowProps<TRow = GridRowData> {
@@ -1389,7 +1467,7 @@ interface GridPagerProps {
     pageSizes?: number[];
     /** Rows after filtering (the thing being paged through). */
     totalRows: number;
-    /** Absolute jump (first/last). */
+    /** Absolute jump (first/last, and a numbered page button). */
     onPage: (page: number) => void;
     /**
      * RELATIVE moves go through their own callbacks so they read the controller's
@@ -1400,9 +1478,22 @@ interface GridPagerProps {
     onNext: () => void;
     onPrevious: () => void;
     onPageSize: (size: number) => void;
-    labels?: Partial<Record<'first' | 'previous' | 'next' | 'last' | 'page' | 'of' | 'rowsPerPage', string>>;
+    /**
+     * Numbered page buttons — `1 2 3 … 40` — in place of "Page 3 of 40"
+     * (`pagination.pageButtons`). The current page's button carries
+     * `aria-current="page"`.
+     */
+    pageButtons?: boolean;
+    /** Most slots the numbered buttons take, ellipses included. Default 7, at least 5. */
+    maxPageButtons?: number;
+    /**
+     * Overrides for the pager's words. `pageButton` is a numbered button's
+     * accessible name, with `{n}` for the page; `navigation` names the pager
+     * itself.
+     */
+    labels?: Partial<Record<'first' | 'previous' | 'next' | 'last' | 'page' | 'of' | 'rowsPerPage' | 'pageButton' | 'navigation', string>>;
 }
-declare function GridPagerImpl({ page, pageCount, pageSize, pageSizes, totalRows, onPage, onNext, onPrevious, onPageSize, labels, }: GridPagerProps): react.JSX.Element;
+declare function GridPagerImpl({ page, pageCount, pageSize, pageSizes, totalRows, onPage, onNext, onPrevious, onPageSize, pageButtons, maxPageButtons, labels, }: GridPagerProps): react.JSX.Element;
 declare const GridPager: react.MemoExoticComponent<typeof GridPagerImpl>;
 
 /** Labels, so the menu can be localized without rebuilding the item list. */
@@ -1504,6 +1595,8 @@ declare function useAlignedGrids<TRow = GridRowData>(controller: DataGridControl
 /** What the tooltip should say and where it should point. */
 interface TooltipState {
     text: string;
+    /** Rich content from a column's `renderTooltip` (P-TOOL-01); drawn instead of `text`. */
+    content?: ReactNode;
     /** Viewport rectangle of the element being described. */
     anchor: {
         top: number;
@@ -1511,6 +1604,14 @@ interface TooltipState {
         width: number;
         height: number;
     };
+    /** `tooltip.interactive`: the pointer may move onto it (P-TOOL-01). */
+    interactive?: boolean;
+    /** The pointer reached the tooltip — keep it open. */
+    hold?: () => void;
+    /** The pointer left the tooltip — close it. */
+    release?: () => void;
+    /** The tooltip element's id, which the described cell points at with `aria-describedby`. */
+    id?: string;
 }
 interface CellTooltipOptions<TRow = GridRowData> {
     rootRef: RefObject<HTMLElement | null>;
@@ -1527,8 +1628,14 @@ interface CellTooltipOptions<TRow = GridRowData> {
      */
     getRowNode: (rawKey: string) => DataRowNode<TRow> | undefined;
     config?: GridTooltipConfig;
+    /**
+     * The grid's controller and id — needed for `trigger: 'focus'` (P-TOOL-01),
+     * which follows the focused cell and finds it by the id the row gives it.
+     */
+    controller?: DataGridController<TRow>;
+    gridId?: string;
 }
-declare function useCellTooltip<TRow = GridRowData>({ rootRef, columnModel, getRowNode, getNote, config, }: CellTooltipOptions<TRow>): TooltipState | null;
+declare function useCellTooltip<TRow = GridRowData>({ rootRef, columnModel, getRowNode, getNote, config, controller, gridId, }: CellTooltipOptions<TRow>): TooltipState | null;
 
 interface GridTooltipProps {
     state: TooltipState;
@@ -1541,6 +1648,12 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
     /** Which edge — decides the sticky side and the border. */
     side: 'top' | 'bottom';
     rows: readonly TRow[];
+    /**
+     * Parallel to `rows`: null for a row the app passed, the data row's key for
+     * one the USER pinned (G-CORE-05) — only those open the pin menu.
+     */
+    rowKeys?: readonly (RowKey | null)[];
+    onUserRowContextMenu?: (key: RowKey, row: TRow, event: React.MouseEvent) => void;
     layout: ColumnLayout<TRow>;
     columnModel: ColumnModel<TRow>;
     centerColumns: ReactColumnRuntime<TRow>[];
@@ -1575,7 +1688,7 @@ interface GridPinnedRowsProps<TRow = GridRowData> {
      */
     ariaRowBase: number;
 }
-declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
+declare function GridPinnedRowsImpl<TRow = GridRowData>({ gridId, side, rows, rowKeys, onUserRowContextMenu, layout, columnModel, centerColumns, centerIndices, stickyInsets, leadingSpacer, trailingSpacer, checkboxColumn, detailColumn, rowNumberColumn, rowHeight, bandOffset, headerRowsBetween, ariaRowBase, }: GridPinnedRowsProps<TRow>): react.JSX.Element | null;
 declare const GridPinnedRows: typeof GridPinnedRowsImpl;
 
 type UseDataGridOptions<TRow = GridRowData> = DataGridCoreConfig<TRow>;
@@ -1649,7 +1762,7 @@ declare function buildCellMenuItems<TRow = GridRowData>(controller: DataGridCont
 interface GridSurfaceProviderProps {
     theme?: GridThemeName;
     density?: GridDensity;
-    palette?: GridPalette;
+    palette?: GridPaletteName;
     children: ReactNode;
 }
 declare function GridSurfaceProvider({ theme, density, palette, children, }: GridSurfaceProviderProps): react.JSX.Element;