@lensui/lens-table 0.1.5 → 0.1.7

package/dist/index.css

@@ -15,6 +15,7 @@
   --rvg-color-primary-soft: #edf4ff;
   --rvg-color-selection-fill: #edf4ff;
   --rvg-color-axis-selection-fill: #e8f2ff;
+  --rvg-color-column-drop-target-fill: #eeeeee;
   --rvg-color-range-fill: #e8f1ff;
   --rvg-color-row-hover-fill: #f6f9fc;
   --rvg-color-hover: #f1f4f8;
@@ -218,9 +219,7 @@
 .rvg-cell-text {
   transition: transform 140ms ease, opacity 100ms ease;
 }
-.rvg-row-drop-settling .rvg-cell-text,
-.rvg-row-drop-settling .rvg-row-drag-icon,
-.rvg-row-drop-settling .rvg-row-selection-icon {
+.rvg-row-drop-settling .rvg-cell-text {
   transition: none;
 }
 .rvg-cell-text > span,
@@ -240,20 +239,6 @@
   white-space: normal;
   text-overflow: clip;
 }
-.rvg-row-drag-icon {
-  position: absolute;
-  display: grid;
-  place-items: center;
-  pointer-events: none;
-  transition: transform 140ms ease, opacity 100ms ease;
-}
-.rvg-row-drag-icon svg {
-  display: block;
-  width: 16px;
-  height: 16px;
-  overflow: visible;
-  fill: var(--rvg-color-icon);
-}
 .rvg-cell-render {
   position: absolute;
   z-index: 1;
@@ -436,16 +421,12 @@
   background: #fce8e6;
   color: #d93025;
 }
-.rvg-row-selection-icon,
 .rvg-header-selection-icon {
   position: absolute;
   display: grid;
   place-items: center;
   pointer-events: none;
 }
-.rvg-row-selection-icon {
-  transition: transform 140ms ease, opacity 100ms ease;
-}
 .rvg-selection-svg {
   display: block;
   width: 16px;
@@ -482,6 +463,7 @@
   border: 2px solid var(--rvg-color-primary);
   box-sizing: border-box;
   pointer-events: none;
+  transition: transform 140ms ease;
 }
 .rvg-selection-edge-target {
   position: absolute;
@@ -767,6 +749,9 @@
 .rvg-header-group.is-leaf {
   z-index: 2;
 }
+.rvg-header-title.is-drop-target {
+  background: var(--rvg-color-column-drop-target-fill);
+}
 .rvg-text-fixed-shadow {
   position: absolute;
   z-index: 4;
@@ -1479,6 +1464,38 @@
   color: var(--rvg-color-muted);
   font-weight: 600;
 }
+.rvg-column-drag-preview-header .rvg-preview-header-icon {
+  position: absolute;
+  top: 50%;
+  width: 14px;
+  height: 14px;
+  transform: translateY(-50%);
+  overflow: visible;
+  color: var(--rvg-color-icon);
+}
+.rvg-column-drag-preview-header .rvg-preview-header-icon path,
+.rvg-column-drag-preview-header .rvg-preview-header-icon circle {
+  fill: currentColor;
+}
+.rvg-column-drag-preview-header .rvg-preview-header-icon path.is-active,
+.rvg-column-drag-preview-header .rvg-preview-header-icon.is-active {
+  color: var(--rvg-color-primary);
+}
+.rvg-column-drag-preview-header .rvg-preview-header-search-icon {
+  fill: none;
+  stroke: currentColor;
+  stroke-width: 1.5;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+}
+.rvg-column-drag-preview-header .rvg-preview-header-search-icon path,
+.rvg-column-drag-preview-header .rvg-preview-header-search-icon circle {
+  fill: none;
+}
+.rvg-is-dragging,
+.rvg-is-dragging * {
+  cursor: move !important;
+}
 .rvg-column-drag-preview-cell.is-axis-selected {
   background: var(--rvg-color-axis-selection-fill);
 }
@@ -1488,12 +1505,18 @@
 .rvg-column-drag-preview-cell.is-selected {
   background: var(--rvg-color-selection-fill);
 }
-.rvg-row-drag-preview {
+.rvg-row-drag-preview-frame {
   position: relative;
   overflow: hidden;
+}
+.rvg-row-drag-preview {
+  position: absolute;
+  top: 2px;
+  left: 2px;
+  overflow: visible;
   border: 1px solid #a9c8f5;
   background: #fff;
-  box-shadow: var(--rvg-shadow-popover);
+  box-shadow: 0 2px 6px rgba(5, 5, 5, 0.08);
   box-sizing: border-box;
 }
 .rvg-row-drag-preview-cell {
@@ -1520,6 +1543,11 @@
   height: 16px;
   fill: var(--rvg-color-icon);
 }
+.rvg-row-drag-preview-cell.is-selected {
+  z-index: 1;
+  background: var(--rvg-color-selection-fill);
+  box-shadow: 0 0 0 2px var(--rvg-color-primary);
+}
 .rvg-preview-checkbox {
   display: grid;
   width: 14px;
@@ -1539,7 +1567,7 @@
   position: absolute;
   z-index: 2;
   margin: 0;
-  padding: 0 9px;
+  padding: 0 10px;
   border: 0;
   border-radius: 0;
   outline: 0;
@@ -1576,7 +1604,7 @@
   position: absolute;
   z-index: 6;
   display: flex;
-  padding: 0 28px 0 9px;
+  padding: 0 28px 0 10px;
   align-items: center;
   gap: 3px;
   background: var(--rvg-color-bg);
@@ -1607,7 +1635,7 @@
   position: absolute;
   z-index: 6;
   display: flex;
-  padding: 0 9px;
+  padding: 0 10px;
   align-items: center;
   gap: 6px;
   overflow: hidden;
@@ -1872,11 +1900,11 @@
   text-align: left;
 }
 .rvg-choice-editor [data-part=trigger] {
-  padding: 0 28px 0 9px;
+  padding: 0 28px 0 10px;
   line-height: 1;
 }
 .rvg-date-value {
-  padding: 0 8px 2px 9px;
+  padding: 0 8px 2px 10px;
 }
 .rvg-choice-editor [data-part=value-text] {
   min-width: 0;

package/dist/index.d.cts

@@ -1,5 +1,4 @@
-import * as react from 'react';
-import { ReactNode, CSSProperties } from 'react';
+import { ReactNode, MouseEvent, CSSProperties, RefAttributes, ReactElement } from 'react';
 
 type GridKey = string | number;
 type SelectionMode = 'single' | 'multiple';
@@ -155,6 +154,14 @@ interface AxisSelectionConfig {
     /** single uses radio-style selection, multiple uses checkbox-style selection. */
     mode?: SelectionMode;
 }
+interface RowSelectionConfig extends AxisSelectionConfig {
+    /** Show the selection column. Defaults to true; when false, click body cells to select rows. */
+    showCheckbox?: boolean;
+}
+interface TableRowNumberConfig {
+    /** Fix the row number column to the left. Defaults to true. */
+    fixed?: boolean;
+}
 /**
  * Column definition consumed by both the canvas renderer and DOM editor layer.
  *
@@ -179,7 +186,7 @@ interface GridColumn<Row> {
     /** Text alignment for body cells and drag previews. */
     align?: 'left' | 'center' | 'right';
     /** Enables double-click / Enter editing when an editor or fallback input exists. */
-    editable?: boolean;
+    editable?: boolean | ((value: unknown, row: Row, rowIndex: number) => boolean);
     /** Built-in editor configuration for text, selectable, date, time, and range cells. */
     editor?: {
         type: 'text';
@@ -219,12 +226,53 @@ interface GridSelection extends GridCellPosition {
     rowKey: GridKey;
     columnKey: string;
 }
+/** Cell locator accepted by controlled and default selection props. */
+type GridSelectionTarget = {
+    columnKey: string;
+    rowKey: GridKey;
+    rowIndex?: number;
+    columnIndex?: number;
+} | {
+    columnKey: string;
+    rowIndex: number;
+    rowKey?: GridKey;
+    columnIndex?: number;
+};
+/** Fully resolved selected cell returned by onSelectedCellChange. */
+interface SelectedCellChange extends GridSelection {
+    value: unknown;
+}
 /** Fired after a cell editor commits a value. */
 interface CellChange<Row> extends GridSelection {
     value: unknown;
     previousValue: unknown;
     row: Row;
 }
+/** Data cell identity and content passed to mouse callbacks. */
+interface TableCellContext<Row> extends GridSelection {
+    row: Row;
+    column: GridColumn<Row>;
+    value: unknown;
+}
+/** Imperative Table API. Selection getters reflect the latest committed render. */
+interface TableRef<Row extends object> {
+    focus: () => void;
+    /** Reveal a data cell without changing selection; false if the target is unavailable. */
+    scrollToCell: (target: GridSelectionTarget) => boolean;
+    getSelectedCell: () => TableCellContext<Row> | null;
+    setSelectedCell: (target: GridSelectionTarget | null) => boolean;
+    getSelectedRowKeys: () => GridKey[];
+    getSelectedRows: () => Row[];
+    setSelectedRowKeys: (keys: GridKey[]) => void;
+    getSelectedColumnKeys: () => string[];
+    setSelectedColumnKeys: (keys: string[]) => void;
+    /** Clear cell, range, row, and column selections. */
+    clearSelection: () => void;
+    /** Select and edit a cell, or edit the current selection. Returns false for invalid or read-only cells. */
+    startEdit: (target?: GridSelectionTarget) => boolean;
+    commitEdit: () => void;
+    cancelEdit: () => void;
+}
 /** Fired when the consumer wants to observe or extend a cell context menu. */
 interface ContextMenuEvent<Row> extends GridSelection {
     row: Row;
@@ -271,24 +319,6 @@ interface TableContextMenuConfig<Row> {
     range?: ContextMenuSection<Row, RangeContextMenuBuiltin, RangeContextMenuContext<Row>>;
 }
 type TableContextMenu<Row> = boolean | TableContextMenuConfig<Row>;
-/** Payload for inserting one or more rows around a target row. */
-interface InsertRowsEvent<Row> {
-    rowIndex: number;
-    row: Row;
-    position: 'before' | 'after';
-    count: number;
-    /** Rows created by the grid for the optimistic visible insert. Consumers can persist these directly. */
-    insertedRows?: Row[];
-}
-/** Payload for deleting the selected rows. */
-interface DeleteRowsEvent<Row> {
-    rows: Array<{
-        rowIndex: number;
-        row: Row;
-    }>;
-    /** Current rendered viewport, including virtual overscan. Useful for fast optimistic updates before rebuilding large datasets. */
-    viewportRange?: ViewportRange;
-}
 /**
  * Public props for Table.
  *
@@ -333,23 +363,25 @@ interface TableProps<Row extends object> {
     /** Show and position the summary row for columns with summary configured. */
     summary?: TableSummaryConfig;
     /** Show an automatically generated row number column on the left. */
-    rowNumber?: boolean;
-    selectedCell?: GridSelection | null;
-    defaultSelectedCell?: GridSelection | null;
-    onSelectedCellChange?: (selection: GridSelection | null) => void;
+    rowNumber?: boolean | TableRowNumberConfig;
+    selectedCell?: GridSelectionTarget | null;
+    defaultSelectedCell?: GridSelectionTarget | null;
+    onSelectedCellChange?: (selection: SelectedCellChange | null) => void;
     /** Enable spreadsheet-style mouse drag selection across multiple body cells. Defaults to false. */
     rangeSelection?: boolean;
-    rowSelection?: boolean | AxisSelectionConfig;
+    rowSelection?: boolean | RowSelectionConfig;
     selectedRowKeys?: GridKey[];
     defaultSelectedRowKeys?: GridKey[];
-    onSelectedRowKeysChange?: (keys: GridKey[], rows: Row[], indices: number[]) => void;
+    onSelectedRowChange?: (keys: GridKey[], rows: Row[], indices: number[]) => void;
     columnSelection?: boolean | AxisSelectionConfig;
     selectedColumnKeys?: string[];
     defaultSelectedColumnKeys?: string[];
-    onSelectedColumnKeysChange?: (keys: string[]) => void;
+    onSelectedColumnChange?: (keys: string[]) => void;
     columnDraggable?: boolean;
     columnResizable?: boolean;
-    onColumnOrderChange?: (sourceIndex: number, targetIndex: number, detail?: {
+    onColumnsReorder?: (columns: GridColumn<Row>[], detail: {
+        sourceIndex: number;
+        targetIndex: number;
         type: 'column' | 'group';
         sourceKey: string;
         targetKey: string;
@@ -358,14 +390,23 @@ interface TableProps<Row extends object> {
     }) => void;
     onColumnResize?: (columnKey: string, width: number) => void;
     rowDraggable?: boolean;
-    onRowOrderChange?: (sourceIndex: number, targetIndex: number) => void;
-    onInsertRows?: (event: InsertRowsEvent<Row>) => void | Promise<void>;
-    onDeleteRows?: (event: DeleteRowsEvent<Row>) => void | Promise<void>;
-    sortState?: GridSortState | null;
-    onSortStateChange?: (state: GridSortState | null) => void;
-    filterValues?: Record<string, string>;
-    onFilterValuesChange?: (values: Record<string, string>) => void;
+    onRowsReorder?: (rows: Row[], detail: {
+        sourceIndex: number;
+        targetIndex: number;
+    }) => void;
+    /** Receives the complete rows array and the rows added by the built-in insert operation. */
+    onInsertRows?: (rows: Row[], insertedRows: Row[]) => void | Promise<void>;
+    /** Receives the complete rows array and the rows removed by the built-in delete operation. */
+    onDeleteRows?: (rows: Row[], deletedRows: Row[]) => void | Promise<void>;
+    /** Overrides the built-in value sorting. Return rows ordered for the internally managed sort state. */
+    onSortChange?: (rows: Row[], state: GridSortState) => Row[];
+    /** Overrides the built-in text filtering. Return the rows that match the internally managed filter values. */
+    onFilterChange?: (rows: Row[], values: Readonly<Record<string, string>>) => Row[];
     onCellChange?: (change: CellChange<Row>) => void | Promise<void>;
+    /** Fires on a data cell click, before the default selection behavior. */
+    onCellClick?: (cell: TableCellContext<Row>, event: MouseEvent<HTMLElement>) => void;
+    /** Fires before double-click editing. preventDefault() cancels editing. */
+    onCellDoubleClick?: (cell: TableCellContext<Row>, event: MouseEvent<HTMLElement>) => void;
     onCellContextMenu?: (event: ContextMenuEvent<Row>) => void;
     /** true uses the built-in menu, false disables custom menus, object customizes menu content and order. */
     contextMenu?: TableContextMenu<Row>;
@@ -381,7 +422,7 @@ interface ViewportRange {
     columnEnd: number;
 }
 
-declare function Table<Row extends object>({ columns: sourceColumns, rows: sourceRows, rowKey, width, height, autoHeight, layout, rowHeight: rowHeightProp, headerHeight: headerHeightProp, fixedHeader, locale, borderless, verticalBorderless, striped, highlight, cellSpans, loading, loadingContent, virtualized, tooltip, summary, rowNumber, selectedCell, defaultSelectedCell, onSelectedCellChange, rangeSelection, rowSelection, selectedRowKeys, defaultSelectedRowKeys, onSelectedRowKeysChange, columnSelection, selectedColumnKeys, defaultSelectedColumnKeys, onSelectedColumnKeysChange, columnDraggable, columnResizable, onColumnOrderChange, onColumnResize, rowDraggable, onRowOrderChange, onInsertRows, onDeleteRows, sortState, onSortStateChange, filterValues, onFilterValuesChange, onCellChange, onCellContextMenu, contextMenu: contextMenuConfig, emptyContent, className, style, ariaLabel, }: TableProps<Row>): react.JSX.Element;
+declare const Table: <Row extends object>(props: TableProps<Row> & RefAttributes<TableRef<Row>>) => ReactElement;
 
 type LayoutColumn<Row> = GridColumn<Row> & {
     rowSelection?: boolean;
@@ -428,4 +469,4 @@ declare function hitTestColumn(metrics: ColumnMetric[], contentX: number): numbe
 
 type TableFilterValues = Record<string, string>;
 
-export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type DeleteRowsEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSortState, type InsertRowsEvent, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type DeleteRowsEvent as TableDeleteRowsEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type InsertRowsEvent as TableInsertRowsEvent, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableResolvedCellSpan, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };
+export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSelectionTarget, type GridSortState, type RowSelectionConfig, type SelectedCellChange, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type TableCellContext, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableRef, type TableResolvedCellSpan, type TableRowNumberConfig, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableRef as VelocityGridRef, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-import * as react from 'react';
-import { ReactNode, CSSProperties } from 'react';
+import { ReactNode, MouseEvent, CSSProperties, RefAttributes, ReactElement } from 'react';
 
 type GridKey = string | number;
 type SelectionMode = 'single' | 'multiple';
@@ -155,6 +154,14 @@ interface AxisSelectionConfig {
     /** single uses radio-style selection, multiple uses checkbox-style selection. */
     mode?: SelectionMode;
 }
+interface RowSelectionConfig extends AxisSelectionConfig {
+    /** Show the selection column. Defaults to true; when false, click body cells to select rows. */
+    showCheckbox?: boolean;
+}
+interface TableRowNumberConfig {
+    /** Fix the row number column to the left. Defaults to true. */
+    fixed?: boolean;
+}
 /**
  * Column definition consumed by both the canvas renderer and DOM editor layer.
  *
@@ -179,7 +186,7 @@ interface GridColumn<Row> {
     /** Text alignment for body cells and drag previews. */
     align?: 'left' | 'center' | 'right';
     /** Enables double-click / Enter editing when an editor or fallback input exists. */
-    editable?: boolean;
+    editable?: boolean | ((value: unknown, row: Row, rowIndex: number) => boolean);
     /** Built-in editor configuration for text, selectable, date, time, and range cells. */
     editor?: {
         type: 'text';
@@ -219,12 +226,53 @@ interface GridSelection extends GridCellPosition {
     rowKey: GridKey;
     columnKey: string;
 }
+/** Cell locator accepted by controlled and default selection props. */
+type GridSelectionTarget = {
+    columnKey: string;
+    rowKey: GridKey;
+    rowIndex?: number;
+    columnIndex?: number;
+} | {
+    columnKey: string;
+    rowIndex: number;
+    rowKey?: GridKey;
+    columnIndex?: number;
+};
+/** Fully resolved selected cell returned by onSelectedCellChange. */
+interface SelectedCellChange extends GridSelection {
+    value: unknown;
+}
 /** Fired after a cell editor commits a value. */
 interface CellChange<Row> extends GridSelection {
     value: unknown;
     previousValue: unknown;
     row: Row;
 }
+/** Data cell identity and content passed to mouse callbacks. */
+interface TableCellContext<Row> extends GridSelection {
+    row: Row;
+    column: GridColumn<Row>;
+    value: unknown;
+}
+/** Imperative Table API. Selection getters reflect the latest committed render. */
+interface TableRef<Row extends object> {
+    focus: () => void;
+    /** Reveal a data cell without changing selection; false if the target is unavailable. */
+    scrollToCell: (target: GridSelectionTarget) => boolean;
+    getSelectedCell: () => TableCellContext<Row> | null;
+    setSelectedCell: (target: GridSelectionTarget | null) => boolean;
+    getSelectedRowKeys: () => GridKey[];
+    getSelectedRows: () => Row[];
+    setSelectedRowKeys: (keys: GridKey[]) => void;
+    getSelectedColumnKeys: () => string[];
+    setSelectedColumnKeys: (keys: string[]) => void;
+    /** Clear cell, range, row, and column selections. */
+    clearSelection: () => void;
+    /** Select and edit a cell, or edit the current selection. Returns false for invalid or read-only cells. */
+    startEdit: (target?: GridSelectionTarget) => boolean;
+    commitEdit: () => void;
+    cancelEdit: () => void;
+}
 /** Fired when the consumer wants to observe or extend a cell context menu. */
 interface ContextMenuEvent<Row> extends GridSelection {
     row: Row;
@@ -271,24 +319,6 @@ interface TableContextMenuConfig<Row> {
     range?: ContextMenuSection<Row, RangeContextMenuBuiltin, RangeContextMenuContext<Row>>;
 }
 type TableContextMenu<Row> = boolean | TableContextMenuConfig<Row>;
-/** Payload for inserting one or more rows around a target row. */
-interface InsertRowsEvent<Row> {
-    rowIndex: number;
-    row: Row;
-    position: 'before' | 'after';
-    count: number;
-    /** Rows created by the grid for the optimistic visible insert. Consumers can persist these directly. */
-    insertedRows?: Row[];
-}
-/** Payload for deleting the selected rows. */
-interface DeleteRowsEvent<Row> {
-    rows: Array<{
-        rowIndex: number;
-        row: Row;
-    }>;
-    /** Current rendered viewport, including virtual overscan. Useful for fast optimistic updates before rebuilding large datasets. */
-    viewportRange?: ViewportRange;
-}
 /**
  * Public props for Table.
  *
@@ -333,23 +363,25 @@ interface TableProps<Row extends object> {
     /** Show and position the summary row for columns with summary configured. */
     summary?: TableSummaryConfig;
     /** Show an automatically generated row number column on the left. */
-    rowNumber?: boolean;
-    selectedCell?: GridSelection | null;
-    defaultSelectedCell?: GridSelection | null;
-    onSelectedCellChange?: (selection: GridSelection | null) => void;
+    rowNumber?: boolean | TableRowNumberConfig;
+    selectedCell?: GridSelectionTarget | null;
+    defaultSelectedCell?: GridSelectionTarget | null;
+    onSelectedCellChange?: (selection: SelectedCellChange | null) => void;
     /** Enable spreadsheet-style mouse drag selection across multiple body cells. Defaults to false. */
     rangeSelection?: boolean;
-    rowSelection?: boolean | AxisSelectionConfig;
+    rowSelection?: boolean | RowSelectionConfig;
     selectedRowKeys?: GridKey[];
     defaultSelectedRowKeys?: GridKey[];
-    onSelectedRowKeysChange?: (keys: GridKey[], rows: Row[], indices: number[]) => void;
+    onSelectedRowChange?: (keys: GridKey[], rows: Row[], indices: number[]) => void;
     columnSelection?: boolean | AxisSelectionConfig;
     selectedColumnKeys?: string[];
     defaultSelectedColumnKeys?: string[];
-    onSelectedColumnKeysChange?: (keys: string[]) => void;
+    onSelectedColumnChange?: (keys: string[]) => void;
     columnDraggable?: boolean;
     columnResizable?: boolean;
-    onColumnOrderChange?: (sourceIndex: number, targetIndex: number, detail?: {
+    onColumnsReorder?: (columns: GridColumn<Row>[], detail: {
+        sourceIndex: number;
+        targetIndex: number;
         type: 'column' | 'group';
         sourceKey: string;
         targetKey: string;
@@ -358,14 +390,23 @@ interface TableProps<Row extends object> {
     }) => void;
     onColumnResize?: (columnKey: string, width: number) => void;
     rowDraggable?: boolean;
-    onRowOrderChange?: (sourceIndex: number, targetIndex: number) => void;
-    onInsertRows?: (event: InsertRowsEvent<Row>) => void | Promise<void>;
-    onDeleteRows?: (event: DeleteRowsEvent<Row>) => void | Promise<void>;
-    sortState?: GridSortState | null;
-    onSortStateChange?: (state: GridSortState | null) => void;
-    filterValues?: Record<string, string>;
-    onFilterValuesChange?: (values: Record<string, string>) => void;
+    onRowsReorder?: (rows: Row[], detail: {
+        sourceIndex: number;
+        targetIndex: number;
+    }) => void;
+    /** Receives the complete rows array and the rows added by the built-in insert operation. */
+    onInsertRows?: (rows: Row[], insertedRows: Row[]) => void | Promise<void>;
+    /** Receives the complete rows array and the rows removed by the built-in delete operation. */
+    onDeleteRows?: (rows: Row[], deletedRows: Row[]) => void | Promise<void>;
+    /** Overrides the built-in value sorting. Return rows ordered for the internally managed sort state. */
+    onSortChange?: (rows: Row[], state: GridSortState) => Row[];
+    /** Overrides the built-in text filtering. Return the rows that match the internally managed filter values. */
+    onFilterChange?: (rows: Row[], values: Readonly<Record<string, string>>) => Row[];
     onCellChange?: (change: CellChange<Row>) => void | Promise<void>;
+    /** Fires on a data cell click, before the default selection behavior. */
+    onCellClick?: (cell: TableCellContext<Row>, event: MouseEvent<HTMLElement>) => void;
+    /** Fires before double-click editing. preventDefault() cancels editing. */
+    onCellDoubleClick?: (cell: TableCellContext<Row>, event: MouseEvent<HTMLElement>) => void;
     onCellContextMenu?: (event: ContextMenuEvent<Row>) => void;
     /** true uses the built-in menu, false disables custom menus, object customizes menu content and order. */
     contextMenu?: TableContextMenu<Row>;
@@ -381,7 +422,7 @@ interface ViewportRange {
     columnEnd: number;
 }
 
-declare function Table<Row extends object>({ columns: sourceColumns, rows: sourceRows, rowKey, width, height, autoHeight, layout, rowHeight: rowHeightProp, headerHeight: headerHeightProp, fixedHeader, locale, borderless, verticalBorderless, striped, highlight, cellSpans, loading, loadingContent, virtualized, tooltip, summary, rowNumber, selectedCell, defaultSelectedCell, onSelectedCellChange, rangeSelection, rowSelection, selectedRowKeys, defaultSelectedRowKeys, onSelectedRowKeysChange, columnSelection, selectedColumnKeys, defaultSelectedColumnKeys, onSelectedColumnKeysChange, columnDraggable, columnResizable, onColumnOrderChange, onColumnResize, rowDraggable, onRowOrderChange, onInsertRows, onDeleteRows, sortState, onSortStateChange, filterValues, onFilterValuesChange, onCellChange, onCellContextMenu, contextMenu: contextMenuConfig, emptyContent, className, style, ariaLabel, }: TableProps<Row>): react.JSX.Element;
+declare const Table: <Row extends object>(props: TableProps<Row> & RefAttributes<TableRef<Row>>) => ReactElement;
 
 type LayoutColumn<Row> = GridColumn<Row> & {
     rowSelection?: boolean;
@@ -428,4 +469,4 @@ declare function hitTestColumn(metrics: ColumnMetric[], contentX: number): numbe
 
 type TableFilterValues = Record<string, string>;
 
-export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type DeleteRowsEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSortState, type InsertRowsEvent, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type DeleteRowsEvent as TableDeleteRowsEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type InsertRowsEvent as TableInsertRowsEvent, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableResolvedCellSpan, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };
+export { type AxisSelectionConfig, type CellChange, type ContextMenuEvent, type GridCellPosition, type GridColumn, type GridKey, type GridSelection, type GridSelectionTarget, type GridSortState, type RowSelectionConfig, type SelectedCellChange, type SelectionMode, type SortDirection, Table, type CellChange as TableCellChange, type TableCellContext, type GridCellPosition as TableCellPosition, type TableCellSpan, type TableCellSpanRule, type TableCellSpanRuleContext, type TableCellSpans, type GridColumn as TableColumn, type TableContextMenu, type TableContextMenuConfig, type ContextMenuEvent as TableContextMenuEvent, type GridSelection as TableEditingCell, type TableFilterValues, type TableHighlightConfig, type GridKey as TableKey, type TableLabels, type TableLayoutConfig, type TableLocaleCode, type TableLocaleConfig, type TableProps, type TableRef, type TableResolvedCellSpan, type TableRowNumberConfig, type GridSortState as TableSorter, type TableSummaryConfig, type TableTooltipConfig, type ViewportRange as TableViewportRange, type TableVirtualizedConfig, Table as VelocityGrid, type TableCellSpan as VelocityGridCellSpan, type TableCellSpanRule as VelocityGridCellSpanRule, type TableCellSpanRuleContext as VelocityGridCellSpanRuleContext, type TableCellSpans as VelocityGridCellSpans, type TableContextMenu as VelocityGridContextMenu, type TableContextMenuConfig as VelocityGridContextMenuConfig, type TableHighlightConfig as VelocityGridHighlightConfig, type TableLabels as VelocityGridLabels, type TableLayoutConfig as VelocityGridLayoutConfig, type TableLocaleCode as VelocityGridLocaleCode, type TableLocaleConfig as VelocityGridLocaleConfig, type TableProps as VelocityGridProps, type TableRef as VelocityGridRef, type TableResolvedCellSpan as VelocityGridResolvedCellSpan, type TableSummaryConfig as VelocityGridSummaryConfig, type TableTooltipConfig as VelocityGridTooltipConfig, type TableVirtualizedConfig as VelocityGridVirtualizedConfig, type ViewportRange, buildColumnMetrics, getViewportRange, hitTestColumn };