@alaarab/ogrid-core 2.1.10 → 2.1.11

package/dist/esm/index.js

@@ -583,20 +583,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;
   }
@@ -787,7 +798,83 @@ function getHeaderFilterConfig(col, input) {
   }
   return base;
 }
-function getCellRenderDescriptor(item, col, rowIndex, colIdx, input) {
+var _CellDescriptorCache = class _CellDescriptorCache {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+    /** Last seen volatile version string. Used to detect when to skip per-cell version checks. */
+    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 * _CellDescriptorCache.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();
+  }
+};
+/**
+ * Stride used to compute a flat cache key: rowIndex * MAX_COL_STRIDE + colIdx.
+ * 1024 supports grids up to 1024 columns, which covers all realistic use cases.
+ * Using a power-of-2 stride lets the JS engine optimize the multiplication.
+ */
+_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);
@@ -1384,6 +1471,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) {
@@ -1393,10 +1481,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++) {
@@ -1422,16 +1525,44 @@ var SIDEBAR_TRANSITION_MS = 300;
 
 // src/constants/zIndex.ts
 var Z_INDEX = {
+  /** Column resize drag handle */
+  RESIZE_HANDLE: 1,
+  /** Active/editing cell outline */
+  ACTIVE_CELL: 2,
+  /** Fill handle dot */
+  FILL_HANDLE: 3,
   /** Selection range overlay (marching ants) */
   SELECTION_OVERLAY: 4,
+  /** Row number column */
+  ROW_NUMBER: 5,
   /** Clipboard overlay (copy/cut animation) */
   CLIPBOARD_OVERLAY: 5,
+  /** Sticky pinned body cells */
+  PINNED: 6,
+  /** Selection checkbox column in body */
+  SELECTION_CELL: 7,
+  /** Sticky thead row */
+  THEAD: 8,
+  /** Pinned header cells (sticky both axes) */
+  PINNED_HEADER: 10,
+  /** Focused header cell */
+  HEADER_FOCUS: 11,
+  /** Checkbox column in sticky header (sticky both axes) */
+  SELECTION_HEADER_PINNED: 12,
+  /** Loading overlay within table */
+  LOADING: 2,
+  /** Column reorder drop indicator */
+  DROP_INDICATOR: 100,
   /** Dropdown menus (column chooser, pagination size select) */
   DROPDOWN: 1e3,
+  /** Filter popovers */
+  FILTER_POPOVER: 1e3,
   /** Modal dialogs */
   MODAL: 2e3,
+  /** Fullscreen grid container */
+  FULLSCREEN: 9999,
   /** Context menus (right-click grid menu) */
-  CONTEXT_MENU: 9999
+  CONTEXT_MENU: 1e4
 };
 
-export { AUTOSIZE_EXTRA_PX, AUTOSIZE_MAX_PX, CELL_PADDING, CHECKBOX_COLUMN_WIDTH, COLUMN_HEADER_MENU_ITEMS, DEFAULT_DEBOUNCE_MS, DEFAULT_MIN_COLUMN_WIDTH, GRID_BORDER_RADIUS, GRID_CONTEXT_MENU_ITEMS, MAX_PAGE_BUTTONS, PAGE_SIZE_OPTIONS, PEOPLE_SEARCH_DEBOUNCE_MS, ROW_NUMBER_COLUMN_WIDTH, SIDEBAR_TRANSITION_MS, UndoRedoStack, Z_INDEX, applyCellDeletion, applyCutClear, applyFillValues, applyPastedValues, applyRangeRowSelection, areGridRowPropsEqual, booleanParser, buildCellIndex, buildCsvHeader, buildCsvRows, buildHeaderRows, buildInlineEditorProps, buildPopoverEditorProps, calculateDropTarget, clampSelectionToBounds, computeAggregations, computeArrowNavigation, computeAutoScrollSpeed, computeNextSortState, computeRowSelectionState, computeTabNavigation, computeTotalHeight, computeVisibleRange, currencyParser, dateParser, debounce, deriveFilterOptionsFromData, emailParser, escapeCsvValue, exportToCsv, findCtrlArrowTarget, flattenColumns, formatCellValueForTsv, formatSelectionAsTsv, formatShortcut, getCellRenderDescriptor, getCellValue, getColumnHeaderMenuItems, getContextMenuHandlers, getDataGridStatusBarConfig, getFilterField, getHeaderFilterConfig, getMultiSelectFilterFields, getPaginationViewModel, getPinStateForColumn, getScrollTopForRow, getStatusBarParts, injectGlobalStyles, isColumnEditable, isFilterConfig, isInSelectionRange, isRowInRange, measureColumnContentWidth, measureRange, mergeFilter, normalizeSelectionRange, numberParser, parseTsvClipboard, parseValue, processClientSideData, rangesEqual, reorderColumnArray, resolveCellDisplayContent, resolveCellStyle, toUserLike, triggerCsvDownload, validateColumns, validateRowIds };
+export { AUTOSIZE_EXTRA_PX, AUTOSIZE_MAX_PX, CELL_PADDING, CHECKBOX_COLUMN_WIDTH, COLUMN_HEADER_MENU_ITEMS, CellDescriptorCache, DEFAULT_DEBOUNCE_MS, DEFAULT_MIN_COLUMN_WIDTH, GRID_BORDER_RADIUS, GRID_CONTEXT_MENU_ITEMS, MAX_PAGE_BUTTONS, PAGE_SIZE_OPTIONS, PEOPLE_SEARCH_DEBOUNCE_MS, ROW_NUMBER_COLUMN_WIDTH, SIDEBAR_TRANSITION_MS, UndoRedoStack, Z_INDEX, applyCellDeletion, applyCutClear, applyFillValues, applyPastedValues, applyRangeRowSelection, areGridRowPropsEqual, booleanParser, buildCellIndex, buildCsvHeader, buildCsvRows, buildHeaderRows, buildInlineEditorProps, buildPopoverEditorProps, calculateDropTarget, clampSelectionToBounds, computeAggregations, computeArrowNavigation, computeAutoScrollSpeed, computeNextSortState, computeRowSelectionState, computeTabNavigation, computeTotalHeight, computeVisibleRange, currencyParser, dateParser, debounce, deriveFilterOptionsFromData, emailParser, escapeCsvValue, exportToCsv, findCtrlArrowTarget, flattenColumns, formatCellValueForTsv, formatSelectionAsTsv, formatShortcut, getCellRenderDescriptor, getCellValue, getColumnHeaderMenuItems, getContextMenuHandlers, getDataGridStatusBarConfig, getFilterField, getHeaderFilterConfig, getMultiSelectFilterFields, getPaginationViewModel, getPinStateForColumn, getScrollTopForRow, getStatusBarParts, injectGlobalStyles, isColumnEditable, isFilterConfig, isInSelectionRange, isRowInRange, measureColumnContentWidth, measureRange, mergeFilter, normalizeSelectionRange, numberParser, parseTsvClipboard, parseValue, processClientSideData, rangesEqual, reorderColumnArray, resolveCellDisplayContent, resolveCellStyle, toUserLike, triggerCsvDownload, validateColumns, validateRowIds, validateVirtualScrollConfig };

package/dist/types/constants/zIndex.d.ts

@@ -1,18 +1,47 @@
 /**
  * Z-index constants for layering OGrid UI elements.
  * Ensures consistent stacking order across all packages.
+ * Values mirror --ogrid-z-* CSS custom properties in _ogrid-theme.scss.
  */
 export declare const Z_INDEX: {
+    /** Column resize drag handle */
+    readonly RESIZE_HANDLE: 1;
+    /** Active/editing cell outline */
+    readonly ACTIVE_CELL: 2;
+    /** Fill handle dot */
+    readonly FILL_HANDLE: 3;
     /** Selection range overlay (marching ants) */
     readonly SELECTION_OVERLAY: 4;
+    /** Row number column */
+    readonly ROW_NUMBER: 5;
     /** Clipboard overlay (copy/cut animation) */
     readonly CLIPBOARD_OVERLAY: 5;
+    /** Sticky pinned body cells */
+    readonly PINNED: 6;
+    /** Selection checkbox column in body */
+    readonly SELECTION_CELL: 7;
+    /** Sticky thead row */
+    readonly THEAD: 8;
+    /** Pinned header cells (sticky both axes) */
+    readonly PINNED_HEADER: 10;
+    /** Focused header cell */
+    readonly HEADER_FOCUS: 11;
+    /** Checkbox column in sticky header (sticky both axes) */
+    readonly SELECTION_HEADER_PINNED: 12;
+    /** Loading overlay within table */
+    readonly LOADING: 2;
+    /** Column reorder drop indicator */
+    readonly DROP_INDICATOR: 100;
     /** Dropdown menus (column chooser, pagination size select) */
     readonly DROPDOWN: 1000;
+    /** Filter popovers */
+    readonly FILTER_POPOVER: 1000;
     /** Modal dialogs */
     readonly MODAL: 2000;
+    /** Fullscreen grid container */
+    readonly FULLSCREEN: 9999;
     /** Context menus (right-click grid menu) */
-    readonly CONTEXT_MENU: 9999;
+    readonly CONTEXT_MENU: 10000;
 };
 /** Type helper for z-index keys */
 export type ZIndexKey = keyof typeof Z_INDEX;

package/dist/types/index.d.ts

@@ -24,7 +24,7 @@ export { getPinStateForColumn, reorderColumnArray, calculateDropTarget, } from '
 export type { ColumnPinState, IDropTarget, ICalculateDropTargetParams } from './utils';
 export { computeVisibleRange, computeTotalHeight, getScrollTopForRow, } from './utils';
 export type { IVisibleRange } from './utils';
-export { getHeaderFilterConfig, getCellRenderDescriptor, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, } from './utils';
+export { getHeaderFilterConfig, getCellRenderDescriptor, CellDescriptorCache, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, } from './utils';
 export type { HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, } from './utils';
 export { debounce } from './utils';
 export { measureRange, buildCellIndex, injectGlobalStyles } from './utils';
@@ -38,7 +38,7 @@ export { rangesEqual, clampSelectionToBounds, computeAutoScrollSpeed, applyRange
 export { formatCellValueForTsv, formatSelectionAsTsv, parseTsvClipboard, applyPastedValues, applyCutClear, } from './utils';
 export { applyFillValues } from './utils';
 export { UndoRedoStack } from './utils';
-export { validateColumns, validateRowIds } from './utils';
+export { validateColumns, validateRowIds, validateVirtualScrollConfig } from './utils';
 export { CHECKBOX_COLUMN_WIDTH, ROW_NUMBER_COLUMN_WIDTH, DEFAULT_MIN_COLUMN_WIDTH, CELL_PADDING, GRID_BORDER_RADIUS, } from './constants';
 export { DEFAULT_DEBOUNCE_MS, PEOPLE_SEARCH_DEBOUNCE_MS, SIDEBAR_TRANSITION_MS, } from './constants';
 export { Z_INDEX } from './constants';

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

@@ -136,6 +136,13 @@ export interface IVirtualScrollConfig {
     rowHeight?: number;
     /** Number of extra rows to render above/below the visible area (default: 5). */
     overscan?: number;
+    /**
+     * Minimum row count before virtual scrolling activates (default: 100).
+     * When totalRows < threshold, all rows are rendered without virtualization.
+     * Lower values activate virtualization earlier (more memory-efficient for mid-size grids);
+     * higher values keep small grids fully rendered (no scroll offset artifacts).
+     */
+    threshold?: number;
 }
 /** Configuration for column reordering via drag-and-drop. */
 export interface IColumnReorderConfig {

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

@@ -94,11 +94,85 @@ export interface CellRenderDescriptor {
     /** Raw value for display (when mode === 'display'). UI uses col.renderCell or col.valueFormatter. */
     displayValue?: unknown;
 }
+/**
+ * Per-grid cache for cell render descriptors.
+ *
+ * Problem: A 50-column × 100-row grid calls getCellRenderDescriptor 5,000 times per render.
+ * Most cells don't change between renders — only cells in the active row, selection range,
+ * or editing row need recomputation. The cache skips recomputation for unchanged cells.
+ *
+ * Design:
+ * - Keyed by (rowIndex * MAX_COL_STRIDE + colIdx) for O(1) flat-array-style access.
+ * - Tracks a "volatile version" string derived from all inputs that affect per-cell output.
+ * - On version match (cache hit), returns the cached descriptor without recomputing.
+ * - On version mismatch (cache miss or first render), recomputes and stores the result.
+ *
+ * Usage: Create one instance per grid (e.g. useRef in React) and pass to getCellRenderDescriptor.
+ *
+ * @example
+ *   const descriptorCache = useRef(new CellDescriptorCache());
+ *   // In renderCellContent:
+ *   getCellRenderDescriptor(item, col, rowIndex, colIdx, input, descriptorCache.current);
+ */
+export declare class CellDescriptorCache {
+    /**
+     * Stride used to compute a flat cache key: rowIndex * MAX_COL_STRIDE + colIdx.
+     * 1024 supports grids up to 1024 columns, which covers all realistic use cases.
+     * Using a power-of-2 stride lets the JS engine optimize the multiplication.
+     */
+    private static readonly MAX_COL_STRIDE;
+    private readonly cache;
+    /** Last seen volatile version string. Used to detect when to skip per-cell version checks. */
+    private 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<T>(input: CellRenderDescriptorInput<T>): string;
+    /**
+     * 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: number, colIdx: number, version: string, compute: () => CellRenderDescriptor): CellRenderDescriptor;
+    /**
+     * 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: string): void;
+    /** The last version string set via updateVersion(). */
+    get currentVersion(): string;
+    /**
+     * 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(): void;
+}
 /**
  * Returns a descriptor for rendering a cell. UI uses this to decide editing-inline vs editing-popover vs display
  * and to apply isActive, isInRange, etc. without duplicating the boolean logic.
+ *
+ * @param item - The row data object.
+ * @param col - The column definition.
+ * @param rowIndex - Row index in the dataset.
+ * @param colIdx - Column index within the visible columns.
+ * @param input - Volatile state inputs (editing cell, active cell, selection ranges, etc.).
+ * @param cache - Optional descriptor cache. When provided and the volatile state is unchanged,
+ *   the cached descriptor is returned without recomputation. Pass a `CellDescriptorCache`
+ *   instance created once per grid (e.g. via `useRef`) and updated each render via
+ *   `CellDescriptorCache.computeVersion`. This eliminates ~5,000 allocations/render on a
+ *   50-col × 100-row grid when selection/editing state hasn't changed for a given cell.
  */
-export declare function getCellRenderDescriptor<T>(item: T, col: IColumnDef<T>, rowIndex: number, colIdx: number, input: CellRenderDescriptorInput<T>): CellRenderDescriptor;
+export declare function getCellRenderDescriptor<T>(item: T, col: IColumnDef<T>, rowIndex: number, colIdx: number, input: CellRenderDescriptorInput<T>, cache?: {
+    get(rowIndex: number, colIdx: number, version: string, compute: () => CellRenderDescriptor): CellRenderDescriptor;
+    currentVersion: string;
+}): CellRenderDescriptor;
 /**
  * Resolves display content for a cell in display mode.
  * Handles the renderCell -> valueFormatter -> String() fallback chain.

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

@@ -21,7 +21,7 @@ export { getPinStateForColumn, reorderColumnArray, calculateDropTarget, } from '
 export type { ColumnPinState, IDropTarget, ICalculateDropTargetParams } from './columnReorder';
 export { computeVisibleRange, computeTotalHeight, getScrollTopForRow, } from './virtualScroll';
 export type { IVisibleRange } from './virtualScroll';
-export { getHeaderFilterConfig, getCellRenderDescriptor, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, } from './dataGridViewModel';
+export { getHeaderFilterConfig, getCellRenderDescriptor, CellDescriptorCache, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, } from './dataGridViewModel';
 export type { HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, } from './dataGridViewModel';
 export { debounce } from './debounce';
 export { measureRange, buildCellIndex, injectGlobalStyles } from './dom';
@@ -35,4 +35,4 @@ export { rangesEqual, clampSelectionToBounds, computeAutoScrollSpeed, applyRange
 export { formatCellValueForTsv, formatSelectionAsTsv, parseTsvClipboard, applyPastedValues, applyCutClear, } from './clipboardHelpers';
 export { applyFillValues } from './fillHelpers';
 export { UndoRedoStack } from './undoRedoStack';
-export { validateColumns, validateRowIds } from './validation';
+export { validateColumns, validateRowIds, validateVirtualScrollConfig } from './validation';

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

@@ -1,13 +1,19 @@
 import type { IColumnDef } from '../types/columnTypes';
-import type { RowId } from '../types/dataGridTypes';
+import type { RowId, IVirtualScrollConfig } from '../types/dataGridTypes';
 /**
  * Validate column definitions at grid initialization.
  * Called once (not per render). Warns on empty/missing/duplicate columnIds.
+ * In development mode, also warns when editable=true but no cellEditor is defined.
  */
 export declare function validateColumns<T>(columns: IColumnDef<T>[]): void;
+/**
+ * Validate virtual scroll configuration.
+ * Dev-only warning when enabled=true but rowHeight is missing or <= 0.
+ */
+export declare function validateVirtualScrollConfig(config: IVirtualScrollConfig): void;
 /**
  * Validate that getRowId returns unique, non-null values.
  * Dev-only (skipped in production). Samples the first 100 rows.
  * Called once on first data render via a hasValidated flag in the caller.
  */
-export declare function validateRowIds<T>(items: T[], getRowId: (item: T) => RowId): void;
+export declare function validateRowIds<T>(items: T[], getRowId: ((item: T) => RowId) | null | undefined): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-core",
-  "version": "2.1.10",
+  "version": "2.1.11",
   "description": "OGrid core – framework-agnostic types, algorithms, and utilities for OGrid data grids.",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",