@kanunilabs/datagrid-react 1.5.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.
@@ -836,8 +872,17 @@ interface GridHeaderProps<TRow = GridRowData> {
      * 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, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, }: 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;
 
 /**
@@ -985,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).
      *
@@ -1065,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, ariaSelectable, selectable, 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> {
@@ -1536,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;
@@ -1543,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>;
@@ -1559,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;
@@ -1573,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>[];
@@ -1607,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>;
@@ -1681,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.
@@ -836,8 +872,17 @@ interface GridHeaderProps<TRow = GridRowData> {
      * 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, selectAllDisabled, onToggleSelectAll, draggable, reorderable, onReorder, resizable, onResize, onAutoFit, onHeaderContextMenu, groupLevels, }: 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;
 
 /**
@@ -985,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).
      *
@@ -1065,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, ariaSelectable, selectable, 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> {
@@ -1536,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;
@@ -1543,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>;
@@ -1559,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;
@@ -1573,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>[];
@@ -1607,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>;
@@ -1681,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;