@alaarab/ogrid-react 2.1.10 → 2.1.12

package/dist/esm/index.js

@@ -566,20 +566,31 @@ function processClientSideData(data, columns, filters, sortBy, sortDirection) {
         if (Number.isNaN(bt)) return 1 * dir;
         return at === bt ? 0 : at > bt ? dir : -dir;
       });
-    } else {
+    } else if (!compare) {
+      const keyCache = /* @__PURE__ */ new Map();
+      for (let i = 0; i < sortable.length; i++) {
+        const row = sortable[i];
+        const v = sortCol ? getCellValue(row, sortCol) : row[sortBy];
+        if (v == null) {
+          keyCache.set(row, void 0);
+        } else if (typeof v === "number") {
+          keyCache.set(row, v);
+        } else {
+          keyCache.set(row, String(v).toLowerCase());
+        }
+      }
       sortable.sort((a, b) => {
-        if (compare) return compare(a, b) * dir;
-        const av = sortCol ? getCellValue(a, sortCol) : a[sortBy];
-        const bv = sortCol ? getCellValue(b, sortCol) : b[sortBy];
-        if (av == null && bv == null) return 0;
-        if (av == null) return -1 * dir;
-        if (bv == null) return 1 * dir;
+        const av = keyCache.get(a);
+        const bv = keyCache.get(b);
+        if (av === void 0 && bv === void 0) return 0;
+        if (av === void 0) return -1 * dir;
+        if (bv === void 0) return 1 * dir;
         if (typeof av === "number" && typeof bv === "number")
           return av === bv ? 0 : av > bv ? dir : -dir;
-        const as = String(av).toLowerCase();
-        const bs = String(bv).toLowerCase();
-        return as === bs ? 0 : as > bs ? dir : -dir;
+        return av === bv ? 0 : av > bv ? dir : -dir;
       });
+    } else {
+      sortable.sort((a, b) => compare(a, b) * dir);
     }
     return sortable;
   }
@@ -735,7 +746,77 @@ function getHeaderFilterConfig(col, input) {
   }
   return base;
 }
-function getCellRenderDescriptor(item, col, rowIndex, colIdx, input) {
+var _CellDescriptorCache = class _CellDescriptorCache2 {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+    this.lastVersion = "";
+  }
+  /**
+   * Compute a version string from the volatile parts of CellRenderDescriptorInput.
+   * This string changes whenever any input that affects per-cell output changes.
+   * Cheap to compute (simple string concat) — O(1) regardless of grid size.
+   */
+  static computeVersion(input) {
+    const ec = input.editingCell;
+    const ac = input.activeCell;
+    const sr = input.selectionRange;
+    const cr = input.cutRange;
+    const cp = input.copyRange;
+    return (ec ? `${String(ec.rowId)}\0${ec.columnId}` : "") + "
" + (ac ? `${ac.rowIndex}\0${ac.columnIndex}` : "") + "
" + (sr ? `${sr.startRow}\0${sr.startCol}\0${sr.endRow}\0${sr.endCol}` : "") + "
" + (cr ? `${cr.startRow}\0${cr.startCol}\0${cr.endRow}\0${cr.endCol}` : "") + "
" + (cp ? `${cp.startRow}\0${cp.startCol}\0${cp.endRow}\0${cp.endCol}` : "") + "
" + (input.isDragging ? "1" : "0") + "
" + (input.editable !== false ? "1" : "0") + "
" + (input.onCellValueChanged ? "1" : "0");
+  }
+  /**
+   * Get a cached descriptor or compute a new one.
+   *
+   * @param rowIndex - Row index in the dataset.
+   * @param colIdx - Column index within the visible columns.
+   * @param version - Volatile version string (from CellDescriptorCache.computeVersion).
+   * @param compute - Factory function called on cache miss.
+   * @returns The descriptor (cached or freshly computed).
+   */
+  get(rowIndex, colIdx, version, compute) {
+    const key = rowIndex * _CellDescriptorCache2.MAX_COL_STRIDE + colIdx;
+    const entry = this.cache.get(key);
+    if (entry !== void 0 && entry.version === version) {
+      return entry.descriptor;
+    }
+    const descriptor = compute();
+    this.cache.set(key, { version, descriptor });
+    return descriptor;
+  }
+  /**
+   * Update the last-seen version and return it.
+   * Call once per render pass to track whether any volatile state changed.
+   * If the version is unchanged from last render, the entire render is a no-op for all cells.
+   */
+  updateVersion(version) {
+    this.lastVersion = version;
+  }
+  /** The last version string set via updateVersion(). */
+  get currentVersion() {
+    return this.lastVersion;
+  }
+  /**
+   * Clear all cached entries. Call when the grid's data changes (new items array,
+   * different column count, etc.) to prevent stale cell values from being served.
+   */
+  clear() {
+    this.cache.clear();
+  }
+};
+_CellDescriptorCache.MAX_COL_STRIDE = 1024;
+var CellDescriptorCache = _CellDescriptorCache;
+function getCellRenderDescriptor(item, col, rowIndex, colIdx, input, cache) {
+  if (cache !== void 0) {
+    return cache.get(
+      rowIndex,
+      colIdx,
+      cache.currentVersion,
+      () => computeCellDescriptor(item, col, rowIndex, colIdx, input)
+    );
+  }
+  return computeCellDescriptor(item, col, rowIndex, colIdx, input);
+}
+function computeCellDescriptor(item, col, rowIndex, colIdx, input) {
   const rowId = input.getRowId(item);
   const globalColIndex = colIdx + input.colOffset;
   const colEditable = isColumnEditable(col, item);
@@ -1291,6 +1372,7 @@ function validateColumns(columns) {
     console.warn("[OGrid] columns prop is empty or not an array");
     return;
   }
+  const isDev = typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
   const ids = /* @__PURE__ */ new Set();
   for (const col of columns) {
     if (!col.columnId) {
@@ -1300,10 +1382,25 @@ function validateColumns(columns) {
       console.warn(`[OGrid] Duplicate columnId: "${col.columnId}"`);
     }
     ids.add(col.columnId);
+    if (isDev && col.editable === true && col.cellEditor == null) {
+      console.warn(
+        `[OGrid] Column "${col.columnId}" has editable=true but no cellEditor defined. Cells will not open an editor on double-click. Set cellEditor to 'text', 'select', 'checkbox', 'date', or a custom component.`
+      );
+    }
+  }
+}
+function validateVirtualScrollConfig(config) {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") return;
+  if (config.enabled !== true) return;
+  if (!config.rowHeight || config.rowHeight <= 0) {
+    console.warn(
+      "[OGrid] virtualScroll.enabled is true but rowHeight is missing or <= 0. Set a positive rowHeight (e.g. virtualScroll: { enabled: true, rowHeight: 36 }) for correct virtual scrolling behavior."
+    );
   }
 }
 function validateRowIds(items, getRowId) {
   if (typeof process !== "undefined" && process.env.NODE_ENV === "production") return;
+  if (!getRowId) return;
   const ids = /* @__PURE__ */ new Set();
   const limit = Math.min(items.length, 100);
   for (let i = 0; i < limit; i++) {
@@ -2690,7 +2787,11 @@ function useKeyboardNavigation(params) {
       const { items, visibleCols, colOffset, hasCheckboxCol, visibleColumnCount, getRowId } = data;
       const { activeCell, selectionRange, editingCell, selectedRowIds } = state;
       const { setActiveCell, setSelectionRange, setEditingCell, handleRowCheckboxChange, handleCopy, handleCut, handlePaste, setContextMenu, onUndo, onRedo, clearClipboardRanges } = handlers;
-      const { editable, onCellValueChanged, rowSelection, wrapperRef } = features;
+      const { editable, onCellValueChanged, rowSelection, wrapperRef, onKeyDown, fillDown } = features;
+      if (onKeyDown) {
+        onKeyDown(e);
+        if (e.defaultPrevented) return;
+      }
       const maxRowIndex = items.length - 1;
       const maxColIndex = visibleColumnCount - 1 + colOffset;
       if (items.length === 0) return;
@@ -2879,6 +2980,15 @@ function useKeyboardNavigation(params) {
             }
           }
           break;
+        case "d":
+          if (e.ctrlKey || e.metaKey) {
+            if (editingCell != null) break;
+            if (editable !== false && fillDown) {
+              e.preventDefault();
+              fillDown();
+            }
+          }
+          break;
         case "Delete":
         case "Backspace": {
           if (editingCell != null) break;
@@ -3170,7 +3280,26 @@ function useFillHandle(params) {
     },
     []
   );
-  return { fillDrag, setFillDrag, handleFillHandleMouseDown };
+  const itemsRef = useLatestRef(items);
+  const visibleColsRef = useLatestRef(visibleCols);
+  const fillDown = useCallback(() => {
+    const range = selectionRangeRef.current;
+    if (!range || editable === false || !onCellValueChangedRef.current) return;
+    const norm = normalizeSelectionRange(range);
+    const fillEvents = applyFillValues(
+      norm,
+      norm.startRow,
+      norm.startCol,
+      itemsRef.current,
+      visibleColsRef.current
+    );
+    if (fillEvents.length > 0) {
+      beginBatch?.();
+      for (const evt of fillEvents) onCellValueChangedRef.current(evt);
+      endBatch?.();
+    }
+  }, [editable, beginBatch, endBatch]);
+  return { fillDrag, setFillDrag, handleFillHandleMouseDown, fillDown };
 }
 function useTableLayout(params) {
   const {
@@ -3710,7 +3839,8 @@ function useDataGridInteraction(params) {
     setActiveCell,
     handleRowCheckboxChange,
     setContextMenuPosition,
-    wrapperRef
+    wrapperRef,
+    onKeyDown
   } = params;
   const undoRedo = useUndoRedo({ onCellValueChanged: onCellValueChangedProp });
   const onCellValueChanged = undoRedo.onCellValueChanged;
@@ -3747,13 +3877,7 @@ function useDataGridInteraction(params) {
     },
     [handleCellMouseDownBase, clearClipboardRanges, wrapperRef]
   );
-  const { handleGridKeyDown } = useKeyboardNavigation({
-    data: { items, visibleCols, colOffset, hasCheckboxCol, visibleColumnCount, getRowId },
-    state: { activeCell, selectionRange, editingCell, selectedRowIds },
-    handlers: { setActiveCell, setSelectionRange, setEditingCell, handleRowCheckboxChange, handleCopy, handleCut, handlePaste, setContextMenu: setContextMenuPosition, onUndo: undoRedo.undo, onRedo: undoRedo.redo, clearClipboardRanges },
-    features: { editable, onCellValueChanged, rowSelection: rowSelection ?? "none", wrapperRef }
-  });
-  const { handleFillHandleMouseDown } = useFillHandle({
+  const { handleFillHandleMouseDown, fillDown } = useFillHandle({
     items,
     visibleCols,
     editable,
@@ -3766,6 +3890,12 @@ function useDataGridInteraction(params) {
     beginBatch: undoRedo.beginBatch,
     endBatch: undoRedo.endBatch
   });
+  const { handleGridKeyDown } = useKeyboardNavigation({
+    data: { items, visibleCols, colOffset, hasCheckboxCol, visibleColumnCount, getRowId },
+    state: { activeCell, selectionRange, editingCell, selectedRowIds },
+    handlers: { setActiveCell, setSelectionRange, setEditingCell, handleRowCheckboxChange, handleCopy, handleCut, handlePaste, setContextMenu: setContextMenuPosition, onUndo: undoRedo.undo, onRedo: undoRedo.redo, clearClipboardRanges },
+    features: { editable, onCellValueChanged, rowSelection: rowSelection ?? "none", wrapperRef, onKeyDown, fillDown }
+  });
   const hasCellSelection = selectionRange != null || activeCell != null;
   const interactionState = useMemo(() => ({
     activeCell: cellSelection ? activeCell : null,
@@ -3867,7 +3997,8 @@ function useDataGridState(params) {
     onAutosizeColumn,
     pinnedColumns,
     onColumnPinned,
-    onCellError
+    onCellError,
+    onKeyDown
   } = props;
   const cellSelection = cellSelectionProp !== false;
   const {
@@ -3936,7 +4067,8 @@ function useDataGridState(params) {
     setActiveCell,
     handleRowCheckboxChange,
     setContextMenuPosition,
-    wrapperRef
+    wrapperRef,
+    onKeyDown
   });
   const {
     selectionRange,
@@ -5771,16 +5903,20 @@ function useVirtualizer(options) {
 }
 
 // src/hooks/useVirtualScroll.ts
-var PASSTHROUGH_THRESHOLD = 100;
+var DEFAULT_PASSTHROUGH_THRESHOLD = 100;
 function useVirtualScroll(params) {
   const {
     totalRows,
     rowHeight,
     enabled,
     overscan = 5,
+    threshold = DEFAULT_PASSTHROUGH_THRESHOLD,
     containerRef
   } = params;
-  const isActive = enabled && totalRows >= PASSTHROUGH_THRESHOLD;
+  useEffect(() => {
+    validateVirtualScrollConfig({ enabled, rowHeight });
+  }, []);
+  const isActive = enabled && totalRows >= threshold;
   const getScrollElement = useCallback(
     () => containerRef.current,
     [containerRef]
@@ -5954,6 +6090,7 @@ function useDataGridTableOrchestration(params) {
     rowHeight: virtualRowHeight,
     enabled: virtualScrollEnabled,
     overscan: virtualScroll?.overscan,
+    threshold: virtualScroll?.threshold,
     containerRef: wrapperRef
   });
   const editCallbacks = useMemo(
@@ -5968,6 +6105,14 @@ function useDataGridTableOrchestration(params) {
   const pendingEditorValueRef = useLatestRef(pendingEditorValue);
   const popoverAnchorElRef = useLatestRef(popoverAnchorEl);
   const selectedRowIdsRef = useLatestRef(selectedRowIds);
+  const cellDescriptorCacheRef = useRef(new CellDescriptorCache());
+  const currentVersion = CellDescriptorCache.computeVersion(cellDescriptorInput);
+  cellDescriptorCacheRef.current.updateVersion(currentVersion);
+  const prevItemsRef = useRef(items);
+  if (prevItemsRef.current !== items) {
+    prevItemsRef.current = items;
+    cellDescriptorCacheRef.current.clear();
+  }
   const handleSingleRowClick = useCallback((e) => {
     if (rowSelection !== "single") return;
     const rowId = e.currentTarget.dataset.rowId;
@@ -6030,6 +6175,7 @@ function useDataGridTableOrchestration(params) {
     interactionHandlers,
     // Stable refs for volatile state
     cellDescriptorInputRef,
+    cellDescriptorCacheRef,
     pendingEditorValueRef,
     popoverAnchorElRef,
     selectedRowIdsRef,
@@ -7300,4 +7446,4 @@ function renderFilterContent(filterType, state, options, isLoadingOptions, selec
   return null;
 }
 
-export { BaseColumnHeaderMenu, BaseDropIndicator, BaseEmptyState, BaseInlineCellEditor, BaseLoadingOverlay, CELL_PADDING, CHECKBOX_COLUMN_WIDTH, COLUMN_HEADER_MENU_ITEMS, CURSOR_CELL_STYLE, CellErrorBoundary, DEFAULT_MIN_COLUMN_WIDTH, DateFilterContent, EmptyState, GRID_BORDER_RADIUS, GRID_CONTEXT_MENU_ITEMS, GRID_ROOT_STYLE, GridContextMenu, MAX_PAGE_BUTTONS, MarchingAntsOverlay, NOOP3 as NOOP, OGridLayout, PAGE_SIZE_OPTIONS, POPOVER_ANCHOR_STYLE, PREVENT_DEFAULT, ROW_NUMBER_COLUMN_WIDTH, STOP_PROPAGATION, SideBar, StatusBar, UndoRedoStack, areGridRowPropsEqual, booleanParser, buildCsvHeader, buildCsvRows, buildHeaderRows, buildInlineEditorProps2 as buildInlineEditorProps, buildPopoverEditorProps2 as buildPopoverEditorProps, clampSelectionToBounds, computeAggregations, computeAutoScrollSpeed, computeTabNavigation, createOGrid, currencyParser, dateParser, deriveFilterOptionsFromData, editorInputStyle, editorWrapperStyle, emailParser, escapeCsvValue, exportToCsv, findCtrlArrowTarget, flattenColumns, formatCellValueForTsv, formatSelectionAsTsv, formatShortcut, getCellInteractionProps, getCellRenderDescriptor, getCellValue, getColumnHeaderFilterStateParams, getColumnHeaderMenuItems, getContextMenuHandlers, getDataGridStatusBarConfig, getDateFilterContentProps, getFilterField, getHeaderFilterConfig, getMultiSelectFilterFields, getPaginationViewModel, getStatusBarParts, isInSelectionRange, isRowInRange, mergeFilter, normalizeSelectionRange, numberParser, parseTsvClipboard, parseValue, processClientSideData, rangesEqual, renderFilterContent, resolveCellDisplayContent2 as resolveCellDisplayContent, resolveCellStyle2 as resolveCellStyle, richSelectDropdownStyle, richSelectNoMatchesStyle, richSelectOptionHighlightedStyle, richSelectOptionStyle, richSelectWrapperStyle, selectChevronStyle, selectDisplayStyle, selectEditorStyle, toUserLike, triggerCsvDownload, useActiveCell, useCellEditing, useCellSelection, useClipboard, useColumnChooserState, useColumnHeaderFilterState, useColumnMeta, useColumnReorder, useColumnResize, useContextMenu, useDataGridState, useDataGridTableOrchestration, useDateFilterState, useDebounce, useFillHandle, useFilterOptions, useInlineCellEditorState, useKeyboardNavigation, useLatestRef, useListVirtualizer, useMultiSelectFilterState, useOGrid, usePaginationControls, usePeopleFilterState, useRichSelectState, useRowSelection, useSelectState, useSideBarState, useTableLayout, useTextFilterState, useUndoRedo, useVirtualScroll };
+export { BaseColumnHeaderMenu, BaseDropIndicator, BaseEmptyState, BaseInlineCellEditor, BaseLoadingOverlay, CELL_PADDING, CHECKBOX_COLUMN_WIDTH, COLUMN_HEADER_MENU_ITEMS, CURSOR_CELL_STYLE, CellDescriptorCache, CellErrorBoundary, DEFAULT_MIN_COLUMN_WIDTH, DateFilterContent, EmptyState, GRID_BORDER_RADIUS, GRID_CONTEXT_MENU_ITEMS, GRID_ROOT_STYLE, GridContextMenu, MAX_PAGE_BUTTONS, MarchingAntsOverlay, NOOP3 as NOOP, OGridLayout, PAGE_SIZE_OPTIONS, POPOVER_ANCHOR_STYLE, PREVENT_DEFAULT, ROW_NUMBER_COLUMN_WIDTH, STOP_PROPAGATION, SideBar, StatusBar, UndoRedoStack, areGridRowPropsEqual, booleanParser, buildCsvHeader, buildCsvRows, buildHeaderRows, buildInlineEditorProps2 as buildInlineEditorProps, buildPopoverEditorProps2 as buildPopoverEditorProps, clampSelectionToBounds, computeAggregations, computeAutoScrollSpeed, computeTabNavigation, createOGrid, currencyParser, dateParser, deriveFilterOptionsFromData, editorInputStyle, editorWrapperStyle, emailParser, escapeCsvValue, exportToCsv, findCtrlArrowTarget, flattenColumns, formatCellValueForTsv, formatSelectionAsTsv, formatShortcut, getCellInteractionProps, getCellRenderDescriptor, getCellValue, getColumnHeaderFilterStateParams, getColumnHeaderMenuItems, getContextMenuHandlers, getDataGridStatusBarConfig, getDateFilterContentProps, getFilterField, getHeaderFilterConfig, getMultiSelectFilterFields, getPaginationViewModel, getStatusBarParts, isInSelectionRange, isRowInRange, mergeFilter, normalizeSelectionRange, numberParser, parseTsvClipboard, parseValue, processClientSideData, rangesEqual, renderFilterContent, resolveCellDisplayContent2 as resolveCellDisplayContent, resolveCellStyle2 as resolveCellStyle, richSelectDropdownStyle, richSelectNoMatchesStyle, richSelectOptionHighlightedStyle, richSelectOptionStyle, richSelectWrapperStyle, selectChevronStyle, selectDisplayStyle, selectEditorStyle, toUserLike, triggerCsvDownload, useActiveCell, useCellEditing, useCellSelection, useClipboard, useColumnChooserState, useColumnHeaderFilterState, useColumnMeta, useColumnReorder, useColumnResize, useContextMenu, useDataGridState, useDataGridTableOrchestration, useDateFilterState, useDebounce, useFillHandle, useFilterOptions, useInlineCellEditorState, useKeyboardNavigation, useLatestRef, useListVirtualizer, useMultiSelectFilterState, useOGrid, usePaginationControls, usePeopleFilterState, useRichSelectState, useRowSelection, useSelectState, useSideBarState, useTableLayout, useTextFilterState, useUndoRedo, useVirtualScroll };

package/dist/types/hooks/useDataGridInteraction.d.ts

@@ -45,6 +45,8 @@ export interface UseDataGridInteractionParams<T> {
         y: number;
     } | null) => void;
     wrapperRef: RefObject<HTMLDivElement | null>;
+    /** Custom keydown handler — called before grid default. preventDefault() suppresses grid handling. */
+    onKeyDown?: (event: React.KeyboardEvent) => void;
 }
 export interface UseDataGridInteractionResult<T> {
     interaction: DataGridCellInteractionState;

package/dist/types/hooks/useDataGridTableOrchestration.d.ts

@@ -6,6 +6,7 @@ import type { UseColumnReorderResult } from './useColumnReorder';
 import type { UseVirtualScrollResult } from './useVirtualScroll';
 import type { HeaderFilterConfigInput, CellRenderDescriptorInput } from '../utils';
 import type { IStatusBarProps, RowId, HeaderRow } from '../types';
+import { CellDescriptorCache } from '@alaarab/ogrid-core';
 /** Parameters for the orchestration hook. */
 export interface UseDataGridTableOrchestrationParams<T> {
     props: IOGridDataGridProps<T>;
@@ -67,6 +68,8 @@ export interface UseDataGridTableOrchestrationResult<T> {
         handleCellContextMenu: DataGridContextMenuState['handleCellContextMenu'];
     };
     cellDescriptorInputRef: React.MutableRefObject<CellRenderDescriptorInput<T>>;
+    /** Per-grid descriptor cache. Eliminates redundant getCellRenderDescriptor allocations for unchanged cells. */
+    cellDescriptorCacheRef: React.MutableRefObject<CellDescriptorCache>;
     pendingEditorValueRef: React.MutableRefObject<unknown>;
     popoverAnchorElRef: React.MutableRefObject<HTMLElement | null>;
     selectedRowIdsRef: React.MutableRefObject<Set<RowId>>;

package/dist/types/hooks/useFillHandle.d.ts

@@ -24,6 +24,8 @@ export interface UseFillHandleResult {
         startCol: number;
     } | null) => void;
     handleFillHandleMouseDown: (e: React.MouseEvent) => void;
+    /** Fill the current selection down from the top row (Ctrl+D). No-op if no selection or editable=false. */
+    fillDown: () => void;
 }
 /**
  * Manages Excel-style fill handle drag-to-fill for cell ranges.

package/dist/types/hooks/useKeyboardNavigation.d.ts

@@ -34,6 +34,8 @@ export interface UseKeyboardNavigationParams<T> {
         onCellValueChanged: ((event: ICellValueChangedEvent<T>) => void) | undefined;
         rowSelection: RowSelectionMode;
         wrapperRef: React.RefObject<HTMLElement | null>;
+        onKeyDown?: (event: React.KeyboardEvent) => void;
+        fillDown?: () => void;
     };
 }
 export interface UseKeyboardNavigationResult {

package/dist/types/hooks/useVirtualScroll.d.ts

@@ -11,6 +11,11 @@ export interface UseVirtualScrollParams {
     enabled: boolean;
     /** Number of extra rows to render outside the visible area. Default: 5. */
     overscan?: number;
+    /**
+     * Minimum row count before virtual scrolling activates. Default: 100.
+     * When totalRows < threshold, all rows render without virtualization.
+     */
+    threshold?: number;
     /** Ref to the scrollable container element. */
     containerRef: RefObject<HTMLElement | null>;
 }
@@ -27,7 +32,7 @@ export interface UseVirtualScrollResult {
 /**
  * Wraps TanStack Virtual for row virtualization.
  * When disabled or when totalRows < threshold, returns a pass-through (all rows visible).
- * @param params - Total rows, row height, enabled flag, overscan, and container ref.
+ * @param params - Total rows, row height, enabled flag, overscan, threshold, and container ref.
  * @returns Virtualizer instance, total height, visible range, and scrollToIndex helper.
  */
 export declare function useVirtualScroll(params: UseVirtualScrollParams): UseVirtualScrollResult;

package/dist/types/index.d.ts

@@ -32,7 +32,7 @@ export { BaseDropIndicator } from './components/BaseDropIndicator';
 export type { BaseDropIndicatorProps } from './components/BaseDropIndicator';
 export { DateFilterContent, getColumnHeaderFilterStateParams, getDateFilterContentProps, } from './components/ColumnHeaderFilterContent';
 export type { IColumnHeaderFilterProps, DateFilterContentProps, DateFilterClassNames, } from './components/ColumnHeaderFilterContent';
-export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, getCellValue, flattenColumns, buildHeaderRows, getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, getStatusBarParts, getDataGridStatusBarConfig, GRID_CONTEXT_MENU_ITEMS, COLUMN_HEADER_MENU_ITEMS, getContextMenuHandlers, getColumnHeaderMenuItems, formatShortcut, getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, getHeaderFilterConfig, getCellRenderDescriptor, isRowInRange, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, computeAggregations, processClientSideData, areGridRowPropsEqual, findCtrlArrowTarget, computeTabNavigation, rangesEqual, clampSelectionToBounds, computeAutoScrollSpeed, formatCellValueForTsv, formatSelectionAsTsv, parseTsvClipboard, UndoRedoStack, } from './utils';
+export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, getCellValue, flattenColumns, buildHeaderRows, getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, getStatusBarParts, getDataGridStatusBarConfig, GRID_CONTEXT_MENU_ITEMS, COLUMN_HEADER_MENU_ITEMS, getContextMenuHandlers, getColumnHeaderMenuItems, formatShortcut, getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, getHeaderFilterConfig, getCellRenderDescriptor, CellDescriptorCache, isRowInRange, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, computeAggregations, processClientSideData, areGridRowPropsEqual, findCtrlArrowTarget, computeTabNavigation, rangesEqual, clampSelectionToBounds, computeAutoScrollSpeed, formatCellValueForTsv, formatSelectionAsTsv, parseTsvClipboard, UndoRedoStack, } from './utils';
 export type { CsvColumn, StatusBarPart, StatusBarPartsInput, GridContextMenuItem, GridContextMenuHandlerProps, PaginationViewModel, HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, CellInteractionHandlers, ParseValueResult, AggregationResult, GridRowComparatorProps, IColumnHeaderMenuItem, ColumnHeaderMenuInput, ColumnHeaderMenuHandlers, } from './utils';
 export { renderFilterContent } from './components/ColumnHeaderFilterRenderers';
 export type { FilterContentRenderers, MultiSelectRendererProps, TextRendererProps, PeopleRendererProps, DateRendererProps, } from './components/ColumnHeaderFilterRenderers';

package/dist/types/types/dataGridTypes.d.ts

@@ -175,4 +175,6 @@ export interface IOGridDataGridProps<T> {
     onCellError?: (error: Error, errorInfo: React.ErrorInfo) => void;
     'aria-label'?: string;
     'aria-labelledby'?: string;
+    /** Custom keydown handler. Called before grid's built-in handling. Call event.preventDefault() to suppress grid default. */
+    onKeyDown?: (event: React.KeyboardEvent) => void;
 }

package/dist/types/utils/index.d.ts

@@ -1,6 +1,7 @@
 export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, getCellValue, flattenColumns, buildHeaderRows, getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, getStatusBarParts, getDataGridStatusBarConfig, getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, GRID_CONTEXT_MENU_ITEMS, COLUMN_HEADER_MENU_ITEMS, getContextMenuHandlers, getColumnHeaderMenuItems, formatShortcut, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, computeAggregations, processClientSideData, computeNextSortState, measureColumnContentWidth, AUTOSIZE_EXTRA_PX, AUTOSIZE_MAX_PX, findCtrlArrowTarget, computeTabNavigation, rangesEqual, clampSelectionToBounds, computeAutoScrollSpeed, formatCellValueForTsv, formatSelectionAsTsv, parseTsvClipboard, applyPastedValues, applyCutClear, applyFillValues, computeArrowNavigation, applyCellDeletion, applyRangeRowSelection, computeRowSelectionState, UndoRedoStack, buildCellIndex, } from '@alaarab/ogrid-core';
 export type { CsvColumn, StatusBarPart, StatusBarPartsInput, GridContextMenuItem, GridContextMenuHandlerProps, PaginationViewModel, ParseValueResult, AggregationResult, IColumnHeaderMenuItem, ColumnHeaderMenuInput, ColumnHeaderMenuHandlers, ArrowNavigationContext, ArrowNavigationResult, } from '@alaarab/ogrid-core';
 export { getHeaderFilterConfig, getCellRenderDescriptor, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, } from './dataGridViewModel';
+export { CellDescriptorCache } from '@alaarab/ogrid-core';
 export type { HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, CellInteractionHandlers, } from './dataGridViewModel';
 export { areGridRowPropsEqual, isRowInRange } from './gridRowComparator';
 export type { GridRowComparatorProps } from './gridRowComparator';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-react",
-  "version": "2.1.10",
+  "version": "2.1.12",
   "description": "OGrid React – React hooks, headless components, and utilities for OGrid data grids.",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",
@@ -39,7 +39,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@alaarab/ogrid-core": "2.1.10",
+    "@alaarab/ogrid-core": "2.1.12",
     "@tanstack/react-virtual": "^3.0.0"
   },
   "peerDependencies": {