@alaarab/ogrid-core 1.8.2 → 2.0.0-beta

package/README.md

@@ -1,48 +1,45 @@
-# @alaarab/ogrid-core
+<p align="center">
+  <strong>OGrid Core</strong> — Pure TypeScript types, algorithms, and utilities for OGrid data grids.
+</p>
 
-Framework-agnostic types, hooks, and utilities for [OGrid](https://github.com/alaarab/ogrid) data tables.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@alaarab/ogrid-core"><img src="https://img.shields.io/npm/v/@alaarab/ogrid-core?color=%23217346&label=npm" alt="npm version" /></a>
+  <a href="https://github.com/alaarab/ogrid/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-blue" alt="TypeScript strict" />
+</p>
 
-This package is the shared foundation used by `@alaarab/ogrid-fluent` and `@alaarab/ogrid-material`. You typically don't need to install it directly -- both framework packages re-export everything from core.
+<p align="center">
+  <a href="https://alaarab.github.io/ogrid/">Documentation</a> · <a href="https://alaarab.github.io/ogrid/docs/getting-started/overview">Getting Started</a> · <a href="https://alaarab.github.io/ogrid/docs/api/ogrid-props">API Reference</a>
+</p>
 
-## Install
+---
 
-```bash
-npm install @alaarab/ogrid-core
-```
+Framework-agnostic foundation for [OGrid](https://github.com/alaarab/ogrid) data grids. **Zero dependencies** — pure TypeScript types and utilities shared by [`@alaarab/ogrid-react`](https://www.npmjs.com/package/@alaarab/ogrid-react) and [`@alaarab/ogrid-js`](https://www.npmjs.com/package/@alaarab/ogrid-js).
+
+You typically don't need to install this directly — the UI packages re-export everything from core.
 
-## What's Included
+## What's Inside
 
 ### Types
 
-- `IColumnDef<T>` -- Column definition with sorting, filtering, and rendering
-- `IDataSource<T>` -- Server-side data source interface
-- `IFetchParams` -- Parameters for `fetchPage()`
-- `IFilters` -- Unified filter values (text, multi-select, people)
-- `UserLike` -- Minimal user shape for people picker
-- `IColumnFilterDef`, `IColumnMeta`, `IPageResult`, `ColumnFilterType`
+`IColumnDef<T>` · `IColumnGroupDef` · `IDataSource<T>` · `IFilters` · `FilterValue` · `IDateFilterValue` · `UserLike` · `IOGridApi<T>` · `IOGridProps<T>` · `IOGridDataGridProps<T>` · `ICellEditorProps<T>` · `IGridColumnState` · `ISideBarDef` · `ColumnFilterType` · `IColumnMeta`
+
+### Utilities
 
-### Hooks
+`getCellValue` · `buildHeaderRows` · `parseValue` · `normalizeSelectionRange` · `isInSelectionRange` · `toUserLike`
 
-- `useOGrid(props, ref)` -- Page/sort/filter/visibleColumns + `dataGridProps` for DataGridTable (used by OGrid wrappers)
-- `useDataGridState({ props, wrapperRef })` -- Orchestrator for grid state, selection, editing, clipboard, keyboard, fill handle, status bar
-- `useFilterOptions(dataSource, fields)` -- Loads filter options for multi-select columns
-- `useColumnHeaderFilterState(params)` -- Headless filter popover state (open, temp values, apply/clear, people search)
-- `useColumnChooserState({ columns, visibleColumns, onVisibilityChange })` -- Column visibility dropdown (open, Escape, select all/clear)
-- `useInlineCellEditorState({ value, editorType, onCommit, onCancel })` -- Inline cell editor (localValue, keydown, blur/commit)
+## Install
 
-### Components
+```bash
+npm install @alaarab/ogrid-core
+```
 
-- `OGridLayout` -- Unified bordered layout: toolbar strip (custom content + column chooser), optional secondary toolbar row, sidebar, grid area, and footer strip (pagination).
+No peer dependencies. No framework dependencies.
 
-### Utilities
+## Documentation
 
-- `getPaginationViewModel(...)` -- Page numbers, ellipsis, start/end item for PaginationControls
-- `getHeaderFilterConfig(col, input)` -- ColumnHeaderFilter props from column + filter/sort state
-- `getCellRenderDescriptor(item, col, rowIndex, colIdx, input)` -- Cell mode (editing-inline / editing-popover / display) and flags for DataGridTable
-- `toUserLike(user)` -- Converts a user-like object to `UserLike`
-- `exportToCsv(items, columns, getValue, filename)` -- Full CSV export
-- `buildCsvHeader`, `buildCsvRows`, `triggerCsvDownload`, `escapeCsvValue` -- Low-level CSV helpers
+Full docs at **[alaarab.github.io/ogrid](https://alaarab.github.io/ogrid/)**.
 
 ## License
 
-MIT
+MIT — Free forever.

package/dist/esm/constants.js

@@ -0,0 +1,11 @@
+/**
+ * Core OGrid constants — magic numbers centralized for consistency and maintainability.
+ */
+/** Width of the row selection checkbox column in pixels. */
+export const CHECKBOX_COLUMN_WIDTH = 48;
+/** Default minimum width for resizable columns in pixels. */
+export const DEFAULT_MIN_COLUMN_WIDTH = 80;
+/** Horizontal padding inside cells, used for width calculations. */
+export const CELL_PADDING = 16;
+/** Border radius for the grid container in pixels. */
+export const GRID_BORDER_RADIUS = 6;

package/dist/esm/index.js

@@ -1,11 +1,6 @@
-export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './types';
-// Hooks
-export { useFilterOptions, useOGrid, useActiveCell, useCellEditing, useContextMenu, useCellSelection, useClipboard, useRowSelection, useKeyboardNavigation, useUndoRedo, useDebounce, useFillHandle, useDataGridState, useColumnHeaderFilterState, useColumnChooserState, useInlineCellEditorState, useColumnResize, useRichSelectState, useSideBarState, } from './hooks';
-// Components
-export { OGridLayout } from './components/OGridLayout';
-export { StatusBar } from './components/StatusBar';
-export { GridContextMenu } from './components/GridContextMenu';
-export { MarchingAntsOverlay } from './components/MarchingAntsOverlay';
-export { SideBar } from './components/SideBar';
-// Utilities
-export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, getCellValue, flattenColumns, buildHeaderRows, getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, getStatusBarParts, getDataGridStatusBarConfig, GRID_CONTEXT_MENU_ITEMS, getContextMenuHandlers, formatShortcut, getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, getHeaderFilterConfig, getCellRenderDescriptor, isRowInRange, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, computeAggregations, processClientSideData, } from './utils';
+// Types
+export * from './types';
+// Utils
+export * from './utils';
+// Constants
+export * from './constants';

package/dist/esm/types/index.js

@@ -1 +1,2 @@
-export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './dataGridTypes';
+// Utility functions
+export { toUserLike, isInSelectionRange, normalizeSelectionRange, } from './dataGridTypes';

package/dist/esm/utils/clientSideData.js

@@ -12,33 +12,37 @@ import { getFilterField } from './ogridHelpers';
  * @returns Filtered and sorted array
  */
 export function processClientSideData(data, columns, filters, sortBy, sortDirection) {
-    let rows = data.slice();
-    // --- Filtering ---
-    columns.forEach((col) => {
+    // --- Filtering (single-pass: build predicates, then one .filter()) ---
+    const predicates = [];
+    for (let i = 0; i < columns.length; i++) {
+        const col = columns[i];
         const filterKey = getFilterField(col);
         const val = filters[filterKey];
         if (!val)
-            return;
+            continue;
         switch (val.type) {
             case 'multiSelect':
                 if (val.value.length > 0) {
-                    rows = rows.filter((r) => val.value.includes(String(getCellValue(r, col))));
+                    const allowedSet = new Set(val.value);
+                    predicates.push((r) => allowedSet.has(String(getCellValue(r, col))));
                 }
                 break;
-            case 'text':
-                if (val.value.trim()) {
-                    const lower = val.value.trim().toLowerCase();
-                    rows = rows.filter((r) => String(getCellValue(r, col) ?? '').toLowerCase().includes(lower));
+            case 'text': {
+                const trimmed = val.value.trim();
+                if (trimmed) {
+                    const lower = trimmed.toLowerCase();
+                    predicates.push((r) => String(getCellValue(r, col) ?? '').toLowerCase().includes(lower));
                 }
                 break;
+            }
             case 'people': {
                 const email = val.value.email.toLowerCase();
-                rows = rows.filter((r) => String(getCellValue(r, col) ?? '').toLowerCase() === email);
+                predicates.push((r) => String(getCellValue(r, col) ?? '').toLowerCase() === email);
                 break;
             }
             case 'date': {
                 const dv = val.value;
-                rows = rows.filter((r) => {
+                predicates.push((r) => {
                     const cellVal = getCellValue(r, col);
                     if (cellVal == null)
                         return false;
@@ -55,7 +59,16 @@ export function processClientSideData(data, columns, filters, sortBy, sortDirect
                 break;
             }
         }
-    });
+    }
+    const rows = predicates.length > 0
+        ? data.filter((row) => {
+            for (let i = 0; i < predicates.length; i++) {
+                if (!predicates[i](row))
+                    return false;
+            }
+            return true;
+        })
+        : data.slice();
     // --- Sorting ---
     if (sortBy) {
         const sortCol = columns.find((c) => c.columnId === sortBy);

package/dist/esm/utils/columnUtils.js

@@ -66,7 +66,12 @@ export function buildHeaderRows(columns, visibleColumns) {
     const totalRows = maxDepth + 1;
     const rows = Array.from({ length: totalRows }, () => []);
     // Step 3: Walk the tree and place cells
+    // Cache leaf counts by children array ref to avoid O(n²) repeated traversals
+    const leafCountCache = new Map();
     function countVisibleLeaves(cols) {
+        const cached = leafCountCache.get(cols);
+        if (cached !== undefined)
+            return cached;
         let count = 0;
         for (const c of cols) {
             if (isColumnGroupDef(c)) {
@@ -78,6 +83,7 @@ export function buildHeaderRows(columns, visibleColumns) {
                 }
             }
         }
+        leafCountCache.set(cols, count);
         return count;
     }
     function walk(cols, depth) {

package/dist/esm/utils/gridRowComparator.js

@@ -0,0 +1,78 @@
+/**
+ * Checks whether a given row index falls within a selection range.
+ * O(1) — used by React.memo comparators to skip unchanged rows.
+ */
+export function isRowInRange(range, rowIndex) {
+    if (!range)
+        return false;
+    const minR = Math.min(range.startRow, range.endRow);
+    const maxR = Math.max(range.startRow, range.endRow);
+    return rowIndex >= minR && rowIndex <= maxR;
+}
+/**
+ * Shared React.memo comparator for GridRow components across all 3 UI packages.
+ * Skips re-render for rows unaffected by selection/editing/interaction changes.
+ *
+ * Used by:
+ * - packages/radix/src/DataGridTable/DataGridTable.tsx
+ * - packages/fluent/src/DataGridTable/DataGridTable.tsx
+ * - packages/material/src/DataGridTable/DataGridTable.tsx
+ */
+export function areGridRowPropsEqual(prev, next) {
+    // Data / structure changes — always re-render
+    if (prev.item !== next.item)
+        return false;
+    if (prev.isSelected !== next.isSelected)
+        return false;
+    if (prev.hasCheckboxCol !== next.hasCheckboxCol)
+        return false;
+    // Framework-specific structure props (compared by identity)
+    if (prev.visibleCols !== next.visibleCols)
+        return false;
+    if (prev.columnMeta !== next.columnMeta)
+        return false;
+    if (prev.cellClassMap !== next.cellClassMap)
+        return false;
+    if (prev.columnLayouts !== next.columnLayouts)
+        return false;
+    const ri = prev.rowIndex;
+    // Editing cell in this row?
+    if (prev.editingRowId !== next.editingRowId) {
+        if (prev.editingRowId === prev.rowId || next.editingRowId === next.rowId)
+            return false;
+    }
+    // Active cell in this row?
+    const prevActive = prev.activeCell?.rowIndex === ri;
+    const nextActive = next.activeCell?.rowIndex === ri;
+    if (prevActive !== nextActive)
+        return false;
+    if (prevActive && nextActive && prev.activeCell.columnIndex !== next.activeCell.columnIndex)
+        return false;
+    // Selection range touches this row?
+    const prevInSel = isRowInRange(prev.selectionRange, ri);
+    const nextInSel = isRowInRange(next.selectionRange, ri);
+    if (prevInSel !== nextInSel)
+        return false;
+    if (prevInSel && nextInSel) {
+        if (prev.selectionRange.startCol !== next.selectionRange.startCol ||
+            prev.selectionRange.endCol !== next.selectionRange.endCol)
+            return false;
+    }
+    // Fill handle (selection end row) + isDragging
+    const prevIsEnd = prev.selectionRange?.endRow === ri;
+    const nextIsEnd = next.selectionRange?.endRow === ri;
+    if (prevIsEnd !== nextIsEnd)
+        return false;
+    if ((prevIsEnd || nextIsEnd) && prev.isDragging !== next.isDragging)
+        return false;
+    // Cut/copy ranges touch this row?
+    if (prev.cutRange !== next.cutRange) {
+        if (isRowInRange(prev.cutRange, ri) || isRowInRange(next.cutRange, ri))
+            return false;
+    }
+    if (prev.copyRange !== next.copyRange) {
+        if (isRowInRange(prev.copyRange, ri) || isRowInRange(next.copyRange, ri))
+            return false;
+    }
+    return true;
+}

package/dist/esm/utils/index.js

@@ -6,7 +6,7 @@ export { getStatusBarParts } from './statusBarHelpers';
 export { getDataGridStatusBarConfig } from './dataGridStatusBar';
 export { getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, } from './paginationHelpers';
 export { GRID_CONTEXT_MENU_ITEMS, getContextMenuHandlers, formatShortcut } from './gridContextMenuHelpers';
-export { getHeaderFilterConfig, getCellRenderDescriptor, isRowInRange, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, } from './dataGridViewModel';
 export { parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, } from './valueParsers';
 export { computeAggregations } from './aggregationUtils';
 export { processClientSideData } from './clientSideData';
+export { areGridRowPropsEqual, isRowInRange } from './gridRowComparator';

package/dist/esm/utils/ogridHelpers.js

@@ -10,7 +10,8 @@ export function mergeFilter(prev, key, value) {
     const isEmpty = value === undefined ||
         (value.type === 'text' && value.value.trim() === '') ||
         (value.type === 'multiSelect' && value.value.length === 0) ||
-        (value.type === 'date' && !value.value.from && !value.value.to);
+        (value.type === 'date' && !value.value.from && !value.value.to) ||
+        (value.type === 'people' && !value.value);
     if (isEmpty) {
         delete next[key];
     }

package/dist/esm/utils/paginationHelpers.js

@@ -3,6 +3,12 @@
  * UI packages use this and render only presentation.
  */
 export const PAGE_SIZE_OPTIONS = [10, 25, 50, 100];
+/** Ensures the active pageSize is included in the options list, inserting it in sorted order if missing. */
+function ensurePageSizeInOptions(pageSize, options) {
+    if (options.includes(pageSize))
+        return options;
+    return [...options, pageSize].sort((a, b) => a - b);
+}
 export const MAX_PAGE_BUTTONS = 5;
 /**
  * Returns a view model for pagination UI. Use in Fluent/Material/Radix PaginationControls
@@ -47,6 +53,6 @@ export function getPaginationViewModel(currentPage, pageSize, totalCount, option
         showEndEllipsis,
         startItem,
         endItem,
-        pageSizeOptions: options?.pageSizeOptions ?? PAGE_SIZE_OPTIONS,
+        pageSizeOptions: ensurePageSizeInOptions(pageSize, options?.pageSizeOptions ?? PAGE_SIZE_OPTIONS),
     };
 }

package/dist/types/constants.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core OGrid constants — magic numbers centralized for consistency and maintainability.
+ */
+/** Width of the row selection checkbox column in pixels. */
+export declare const CHECKBOX_COLUMN_WIDTH = 48;
+/** Default minimum width for resizable columns in pixels. */
+export declare const DEFAULT_MIN_COLUMN_WIDTH = 80;
+/** Horizontal padding inside cells, used for width calculations. */
+export declare const CELL_PADDING = 16;
+/** Border radius for the grid container in pixels. */
+export declare const GRID_BORDER_RADIUS = 6;

package/dist/types/index.d.ts

@@ -1,16 +1,3 @@
-export type { ColumnFilterType, IColumnFilterDef, IColumnMeta, IColumnDef, IColumnGroupDef, IColumnDefinition, ICellValueChangedEvent, ICellEditorProps, CellEditorParams, IValueParserParams, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, IOGridProps, IOGridDataGridProps, RowSelectionMode, RowId, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, HeaderCell, HeaderRow, SideBarPanelId, ISideBarDef, IDateFilterValue, } from './types';
-export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './types';
-export { useFilterOptions, useOGrid, useActiveCell, useCellEditing, useContextMenu, useCellSelection, useClipboard, useRowSelection, useKeyboardNavigation, useUndoRedo, useDebounce, useFillHandle, useDataGridState, useColumnHeaderFilterState, useColumnChooserState, useInlineCellEditorState, useColumnResize, useRichSelectState, useSideBarState, } from './hooks';
-export type { UseFilterOptionsResult, UseOGridResult, ColumnChooserPlacement, UseActiveCellResult, UseCellEditingResult, EditingCell, UseContextMenuResult, ContextMenuPosition, UseCellSelectionResult, UseCellSelectionParams, UseClipboardResult, UseClipboardParams, UseRowSelectionResult, UseRowSelectionParams, UseKeyboardNavigationResult, UseKeyboardNavigationParams, UseUndoRedoResult, UseUndoRedoParams, UseFillHandleResult, UseFillHandleParams, UseDataGridStateParams, UseDataGridStateResult, DataGridLayoutState, DataGridRowSelectionState, DataGridEditingState, DataGridCellInteractionState, DataGridContextMenuState, DataGridViewModelState, UseColumnHeaderFilterStateParams, UseColumnHeaderFilterStateResult, UseColumnChooserStateParams, UseColumnChooserStateResult, UseInlineCellEditorStateParams, UseInlineCellEditorStateResult, InlineCellEditorType, UseColumnResizeParams, UseColumnResizeResult, UseRichSelectStateParams, UseRichSelectStateResult, UseSideBarStateParams, UseSideBarStateResult, } from './hooks';
-export { OGridLayout } from './components/OGridLayout';
-export type { OGridLayoutProps } from './components/OGridLayout';
-export { StatusBar } from './components/StatusBar';
-export type { StatusBarProps, StatusBarClassNames } from './components/StatusBar';
-export { GridContextMenu } from './components/GridContextMenu';
-export type { GridContextMenuProps, GridContextMenuClassNames } from './components/GridContextMenu';
-export { MarchingAntsOverlay } from './components/MarchingAntsOverlay';
-export type { MarchingAntsOverlayProps } from './components/MarchingAntsOverlay';
-export { SideBar } from './components/SideBar';
-export type { SideBarProps, SideBarFilterColumn } from './components/SideBar';
-export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, getCellValue, flattenColumns, buildHeaderRows, getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, getStatusBarParts, getDataGridStatusBarConfig, GRID_CONTEXT_MENU_ITEMS, getContextMenuHandlers, formatShortcut, getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, getHeaderFilterConfig, getCellRenderDescriptor, isRowInRange, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, computeAggregations, processClientSideData, } from './utils';
-export type { CsvColumn, StatusBarPart, StatusBarPartsInput, GridContextMenuItem, GridContextMenuHandlerProps, PaginationViewModel, HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, CellInteractionHandlers, ParseValueResult, AggregationResult, } from './utils';
+export * from './types';
+export * from './utils';
+export * from './constants';

package/dist/types/types/columnTypes.d.ts

@@ -1,4 +1,3 @@
-import * as React from 'react';
 export type ColumnFilterType = 'none' | 'text' | 'multiSelect' | 'people' | 'date';
 /** Date range filter value (ISO YYYY-MM-DD strings). Both fields optional for open-ended ranges. */
 export interface IDateFilterValue {
@@ -40,7 +39,6 @@ export interface IValueParserParams<T = unknown> {
     column: IColumnDef<T>;
 }
 export interface IColumnDef<T = unknown> extends IColumnMeta {
-    renderCell?: (item: T) => React.ReactNode;
     compare?: (a: T, b: T) => number;
     /** Compute cell value from row data (used for filtering, sorting, display when no renderCell). */
     valueGetter?: (item: T) => unknown;
@@ -52,12 +50,11 @@ export interface IColumnDef<T = unknown> extends IColumnMeta {
      * Return the parsed value to use, or `undefined` to reject (skip) the change.
      */
     valueParser?: (params: IValueParserParams<T>) => unknown;
-    /** Static or per-row cell inline styles. */
-    cellStyle?: React.CSSProperties | ((item: T) => React.CSSProperties);
     /** Whether the cell is editable (per-column or per-row). */
     editable?: boolean | ((item: T) => boolean);
-    /** Built-in editor type or custom React component. */
-    cellEditor?: 'text' | 'select' | 'checkbox' | 'richSelect' | 'date' | React.ComponentType<ICellEditorProps<T>>;
+    /** Built-in editor type or framework-specific custom editor (e.g. React component).
+     *  Core utilities never inspect this value — framework packages narrow the type. */
+    cellEditor?: unknown;
     /** When true, custom cell editor is rendered in a popover/popper instead of inline. */
     cellEditorPopup?: boolean;
     /** Params passed to the cell editor (e.g. { values: string[] } for select). */
@@ -67,7 +64,6 @@ export interface IColumnDef<T = unknown> extends IColumnMeta {
 export interface ICellValueChangedEvent<T> {
     item: T;
     columnId: string;
-    field: string;
     oldValue: unknown;
     newValue: unknown;
     rowIndex: number;
@@ -82,12 +78,12 @@ export interface ICellEditorProps<T> {
     column: IColumnDef<T>;
     cellEditorParams?: CellEditorParams;
 }
-/** Params for built-in cell editors (e.g. select: { values: string[] }). Extend for custom editors. */
+/** Params for built-in cell editors (e.g. select: { values: string[] }). */
 export interface CellEditorParams {
+    /** Array of allowed values for select/richSelect editors. */
     values?: unknown[];
     /** Format a value for display in rich select editor. */
     formatValue?: (value: unknown) => string;
-    [key: string]: unknown;
 }
 /** Column group for multi-row header (has children, no columnId for data). */
 export interface IColumnGroupDef<T = unknown> {

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

@@ -1,5 +1,4 @@
-import type { ReactNode } from 'react';
-import type { IColumnDef, IColumnGroupDef, ICellValueChangedEvent, IDateFilterValue } from './columnTypes';
+import type { IDateFilterValue } from './columnTypes';
 /** Row identifier type — grids accept string or number IDs. */
 export type RowId = string | number;
 export interface UserLike {
@@ -149,136 +148,16 @@ export interface IOGridApi<T> {
     selectAll: () => void;
     /** Deselect all rows. */
     deselectAll: () => void;
-}
-/** Props for the OGrid wrapper component (shared across Fluent, Material, Radix). */
-export interface IOGridProps<T> {
-    columns: (IColumnDef<T> | IColumnGroupDef<T>)[];
-    getRowId: (item: T) => RowId;
-    data?: T[];
-    dataSource?: IDataSource<T>;
-    page?: number;
-    pageSize?: number;
-    sort?: {
-        field: string;
-        direction: 'asc' | 'desc';
-    };
-    filters?: IFilters;
-    visibleColumns?: Set<string>;
-    isLoading?: boolean;
-    onPageChange?: (page: number) => void;
-    onPageSizeChange?: (size: number) => void;
-    onSortChange?: (sort: {
-        field: string;
-        direction: 'asc' | 'desc';
+    /** Clear all filters (shorthand for setFilterModel({})). */
+    clearFilters: () => void;
+    /** Reset sort to the default (first column, ascending). */
+    clearSort: () => void;
+    /** Reset all grid state (filters, sort, selection). */
+    resetGridState: (options?: {
+        keepSelection?: boolean;
     }) => void;
-    onFiltersChange?: (filters: IFilters) => void;
-    onVisibleColumnsChange?: (cols: Set<string>) => void;
-    columnOrder?: string[];
-    onColumnOrderChange?: (order: string[]) => void;
-    /** Called when a column is resized by the user. */
-    onColumnResized?: (columnId: string, width: number) => void;
-    /** Called when a column is pinned or unpinned. */
-    onColumnPinned?: (columnId: string, pinned: 'left' | 'right' | null) => void;
-    freezeRows?: number;
-    freezeCols?: number;
-    editable?: boolean;
-    /** Enable spreadsheet-like cell selection (active cell, range, fill handle, clipboard, context menu). Default: true. */
-    cellSelection?: boolean;
-    onCellValueChanged?: (event: ICellValueChangedEvent<T>) => void;
-    onUndo?: () => void;
-    onRedo?: () => void;
-    canUndo?: boolean;
-    canRedo?: boolean;
-    rowSelection?: RowSelectionMode;
-    selectedRows?: Set<RowId>;
-    onSelectionChange?: (event: IRowSelectionChangeEvent<T>) => void;
-    statusBar?: boolean | IStatusBarProps;
-    defaultPageSize?: number;
-    defaultSortBy?: string;
-    defaultSortDirection?: 'asc' | 'desc';
-    toolbar?: ReactNode;
-    /** Secondary toolbar row rendered below the primary toolbar (e.g. active filter chips). */
-    toolbarBelow?: ReactNode;
-    emptyState?: {
-        message?: ReactNode;
-        render?: () => ReactNode;
-    };
-    entityLabelPlural?: string;
-    className?: string;
-    /** Where the column chooser renders.
-     *  - `true` or `'toolbar'` (default): column chooser button in the toolbar strip.
-     *  - `'sidebar'`: column chooser only available via the sidebar columns panel.
-     *  - `false`: column chooser hidden entirely. */
-    columnChooser?: boolean | 'toolbar' | 'sidebar';
-    layoutMode?: 'content' | 'fill';
-    /** When true, horizontal scrolling is suppressed (overflow-x hidden). */
-    suppressHorizontalScroll?: boolean;
-    /** Side bar configuration. `true` shows default panels (columns + filters). Pass ISideBarDef for options. */
-    sideBar?: boolean | ISideBarDef;
-    /** Page size options shown in the pagination dropdown. Default: [10, 20, 50, 100]. */
-    pageSizeOptions?: number[];
-    /** Fires once when the grid first renders with data (useful for restoring column state). */
-    onFirstDataRendered?: () => void;
-    /** Called when server-side fetchPage fails. */
-    onError?: (error: unknown) => void;
-    'aria-label'?: string;
-    'aria-labelledby'?: string;
-}
-/** Props passed from useOGrid to the framework-specific DataGridTable. */
-export interface IOGridDataGridProps<T> {
-    items: T[];
-    columns: (IColumnDef<T> | IColumnGroupDef<T>)[];
-    getRowId: (item: T) => RowId;
-    sortBy?: string;
-    sortDirection: 'asc' | 'desc';
-    onColumnSort: (columnKey: string) => void;
-    visibleColumns: Set<string>;
-    /** Optional column display order (column ids). When set, visible columns are ordered by this array. */
-    columnOrder?: string[];
-    onColumnOrderChange?: (order: string[]) => void;
-    /** Called when a column is resized by the user. */
-    onColumnResized?: (columnId: string, width: number) => void;
-    /** Called when a column is pinned or unpinned. */
-    onColumnPinned?: (columnId: string, pinned: 'left' | 'right' | null) => void;
-    /** Runtime pin overrides (from restored state or programmatic changes). */
-    pinnedColumns?: Record<string, 'left' | 'right'>;
-    /** Initial column width overrides (from restored state). */
-    initialColumnWidths?: Record<string, number>;
-    /** Number of rows to freeze (sticky), e.g. 1 = header row. */
-    freezeRows?: number;
-    /** Number of data columns to freeze (sticky left). */
-    freezeCols?: number;
-    layoutMode?: 'content' | 'fill';
-    /** When true, horizontal scrolling is suppressed (overflow-x hidden). */
-    suppressHorizontalScroll?: boolean;
-    isLoading?: boolean;
-    loadingMessage?: string;
-    editable?: boolean;
-    /** Enable spreadsheet-like cell selection. Default: true. */
-    cellSelection?: boolean;
-    onCellValueChanged?: (event: ICellValueChangedEvent<T>) => void;
-    onUndo?: () => void;
-    onRedo?: () => void;
-    canUndo?: boolean;
-    canRedo?: boolean;
-    rowSelection?: RowSelectionMode;
-    selectedRows?: Set<RowId>;
-    onSelectionChange?: (event: IRowSelectionChangeEvent<T>) => void;
-    statusBar?: IStatusBarProps;
-    /** Unified filter model (discriminated union values). */
-    filters: IFilters;
-    /** Single callback for all filter changes. Pass undefined to clear. */
-    onFilterChange: (key: string, value: FilterValue | undefined) => void;
-    filterOptions: Record<string, string[]>;
-    loadingFilterOptions: Record<string, boolean>;
-    peopleSearch?: (query: string) => Promise<UserLike[]>;
-    getUserByEmail?: (email: string) => Promise<UserLike | undefined>;
-    emptyState?: {
-        onClearAll: () => void;
-        hasActiveFilters: boolean;
-        message?: ReactNode;
-        render?: () => ReactNode;
-    };
-    'aria-label'?: string;
-    'aria-labelledby'?: string;
+    /** Get the currently displayed (paginated) rows. */
+    getDisplayedRows: () => T[];
+    /** Re-trigger a data fetch (server-side only; no-op for client-side). */
+    refreshData: () => void;
 }

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

@@ -1,3 +1,3 @@
-export type { ColumnFilterType, IColumnFilterDef, IColumnMeta, IColumnDef, IColumnGroupDef, IColumnDefinition, ICellValueChangedEvent, ICellEditorProps, CellEditorParams, IValueParserParams, IDateFilterValue, HeaderCell, HeaderRow, } from './columnTypes';
-export type { RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, IOGridProps, IOGridDataGridProps, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, SideBarPanelId, ISideBarDef, } from './dataGridTypes';
-export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './dataGridTypes';
+export type { ColumnFilterType, IDateFilterValue, IColumnFilterDef, IColumnMeta, IValueParserParams, IColumnDef, ICellValueChangedEvent, ICellEditorProps, CellEditorParams, IColumnGroupDef, HeaderCell, HeaderRow, IColumnDefinition, } from './columnTypes';
+export type { RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, SideBarPanelId, ISideBarDef, IOGridApi, } from './dataGridTypes';
+export { toUserLike, isInSelectionRange, normalizeSelectionRange, } from './dataGridTypes';

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

@@ -0,0 +1,57 @@
+/**
+ * Checks whether a given row index falls within a selection range.
+ * O(1) — used by React.memo comparators to skip unchanged rows.
+ */
+export declare function isRowInRange(range: {
+    startRow: number;
+    endRow: number;
+} | null, rowIndex: number): boolean;
+/**
+ * Props for GridRow comparator (generic to work with all 3 UI frameworks).
+ * Includes both render props and comparator-only props used to decide re-renders.
+ */
+export interface GridRowComparatorProps {
+    item: unknown;
+    rowIndex: number;
+    rowId: string | number;
+    isSelected: boolean;
+    hasCheckboxCol: boolean;
+    selectionRange: {
+        startRow: number;
+        endRow: number;
+        startCol: number;
+        endCol: number;
+    } | null;
+    activeCell: {
+        rowIndex: number;
+        columnIndex: number;
+    } | null;
+    cutRange: {
+        startRow: number;
+        endRow: number;
+        startCol: number;
+        endCol: number;
+    } | null;
+    copyRange: {
+        startRow: number;
+        endRow: number;
+        startCol: number;
+        endCol: number;
+    } | null;
+    isDragging: boolean;
+    editingRowId: string | number | null;
+    visibleCols?: unknown;
+    columnMeta?: unknown;
+    cellClassMap?: unknown;
+    columnLayouts?: unknown;
+}
+/**
+ * Shared React.memo comparator for GridRow components across all 3 UI packages.
+ * Skips re-render for rows unaffected by selection/editing/interaction changes.
+ *
+ * Used by:
+ * - packages/radix/src/DataGridTable/DataGridTable.tsx
+ * - packages/fluent/src/DataGridTable/DataGridTable.tsx
+ * - packages/material/src/DataGridTable/DataGridTable.tsx
+ */
+export declare function areGridRowPropsEqual(prev: GridRowComparatorProps, next: GridRowComparatorProps): boolean;