@alaarab/ogrid-core 1.3.1 → 1.4.0

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

@@ -0,0 +1,15 @@
+import type { SideBarPanelId, ISideBarDef } from '../types';
+export interface UseSideBarStateParams {
+    config: boolean | ISideBarDef | undefined;
+}
+export interface UseSideBarStateResult {
+    isEnabled: boolean;
+    activePanel: SideBarPanelId | null;
+    setActivePanel: (panel: SideBarPanelId | null) => void;
+    panels: SideBarPanelId[];
+    position: 'left' | 'right';
+    isOpen: boolean;
+    toggle: (panel: SideBarPanelId) => void;
+    close: () => void;
+}
+export declare function useSideBarState(params: UseSideBarStateParams): UseSideBarStateResult;

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
-export type { ColumnFilterType, IColumnFilterDef, IColumnMeta, IColumnDef, IColumnGroupDef, IColumnDefinition, ICellValueChangedEvent, ICellEditorProps, CellEditorParams, IValueParserParams, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, IOGridProps, IOGridDataGridProps, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, } from './types';
+export type { ColumnFilterType, IColumnFilterDef, IColumnMeta, IColumnDef, IColumnGroupDef, IColumnDefinition, ICellValueChangedEvent, ICellEditorProps, CellEditorParams, IValueParserParams, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, IOGridProps, IOGridDataGridProps, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, HeaderCell, HeaderRow, SideBarPanelId, ISideBarDef, IDateFilterValue, } from './types';
 export { toUserLike, toDataGridFilterProps, isInSelectionRange, normalizeSelectionRange } from './types';
-export { useFilterOptions, useOGrid, useActiveCell, useCellEditing, useContextMenu, useCellSelection, useClipboard, useRowSelection, useKeyboardNavigation, useUndoRedo, useDebounce, useFillHandle, useDataGridState, useColumnHeaderFilterState, useColumnChooserState, useInlineCellEditorState, useColumnResize, } from './hooks';
-export type { UseFilterOptionsResult, UseOGridResult, UseActiveCellResult, UseCellEditingResult, EditingCell, UseContextMenuResult, ContextMenuPosition, UseCellSelectionResult, UseCellSelectionParams, UseClipboardResult, UseClipboardParams, UseRowSelectionResult, UseRowSelectionParams, UseKeyboardNavigationResult, UseKeyboardNavigationParams, UseUndoRedoResult, UseUndoRedoParams, UseFillHandleResult, UseFillHandleParams, UseDataGridStateParams, UseDataGridStateResult, UseColumnHeaderFilterStateParams, UseColumnHeaderFilterStateResult, UseColumnChooserStateParams, UseColumnChooserStateResult, UseInlineCellEditorStateParams, UseInlineCellEditorStateResult, InlineCellEditorType, UseColumnResizeParams, UseColumnResizeResult, } from './hooks';
+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, 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';
@@ -10,5 +10,7 @@ export { GridContextMenu } from './components/GridContextMenu';
 export type { GridContextMenuProps, GridContextMenuClassNames } from './components/GridContextMenu';
 export { MarchingAntsOverlay } from './components/MarchingAntsOverlay';
 export type { MarchingAntsOverlayProps } from './components/MarchingAntsOverlay';
-export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, getCellValue, flattenColumns, getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, getStatusBarParts, getDataGridStatusBarConfig, GRID_CONTEXT_MENU_ITEMS, getContextMenuHandlers, formatShortcut, getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, getHeaderFilterConfig, getCellRenderDescriptor, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, } from './utils';
-export type { CsvColumn, StatusBarPart, StatusBarPartsInput, GridContextMenuItem, GridContextMenuHandlerProps, PaginationViewModel, HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, ParseValueResult, } from './utils';
+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, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, computeAggregations, } from './utils';
+export type { CsvColumn, StatusBarPart, StatusBarPartsInput, GridContextMenuItem, GridContextMenuHandlerProps, PaginationViewModel, HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, CellInteractionHandlers, ParseValueResult, AggregationResult, } from './utils';

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

@@ -1,5 +1,10 @@
 import * as React from 'react';
-export type ColumnFilterType = 'none' | 'text' | 'multiSelect' | 'people';
+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 {
+    from?: string;
+    to?: string;
+}
 export interface IColumnFilterDef {
     type: Exclude<ColumnFilterType, 'none'>;
     filterField?: string;
@@ -10,6 +15,8 @@ export interface IColumnFilterDef {
 export interface IColumnMeta {
     columnId: string;
     name: string;
+    /** Column type shorthand. Affects alignment, default editor, filter type, sorting, and display formatting. */
+    type?: 'text' | 'numeric' | 'date' | 'boolean';
     sortable?: boolean;
     /** Omit for not filterable; set to IColumnFilterDef for filterable. */
     filterable?: IColumnFilterDef;
@@ -50,7 +57,7 @@ export interface IColumnDef<T = unknown> extends IColumnMeta {
     /** 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' | React.ComponentType<ICellEditorProps<T>>;
+    cellEditor?: 'text' | 'select' | 'checkbox' | 'richSelect' | 'date' | React.ComponentType<ICellEditorProps<T>>;
     /** 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). */
@@ -78,6 +85,8 @@ export interface ICellEditorProps<T> {
 /** Params for built-in cell editors (e.g. select: { values: string[] }). Extend for custom editors. */
 export interface CellEditorParams {
     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). */
@@ -87,6 +96,21 @@ export interface IColumnGroupDef<T = unknown> {
     /** Nested groups or leaf columns. */
     children: (IColumnGroupDef<T> | IColumnDef<T>)[];
 }
+/** A single cell in a header row (either a group header or a leaf column header). */
+export interface HeaderCell<T = unknown> {
+    /** Display text for this header cell. */
+    label: string;
+    /** Number of leaf columns this cell spans. */
+    colSpan: number;
+    /** True if this is a group header (not a leaf column). */
+    isGroup: boolean;
+    /** The leaf column definition (only set when isGroup is false). */
+    columnDef?: IColumnDef<T>;
+    /** The depth level of this cell in the group tree (0 = top). */
+    depth: number;
+}
+/** A single row in the multi-row header. */
+export type HeaderRow<T = unknown> = HeaderCell<T>[];
 /** Minimal column info for the ColumnChooser (framework-agnostic). */
 export interface IColumnDefinition {
     columnId: string;

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

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { IColumnDef, IColumnGroupDef, ICellValueChangedEvent } from './columnTypes';
+import type { IColumnDef, IColumnGroupDef, ICellValueChangedEvent, IDateFilterValue } from './columnTypes';
 /** Row identifier type — grids accept string or number IDs. */
 export type RowId = string | number;
 export interface UserLike {
@@ -18,17 +18,18 @@ export type UserLikeInput = {
     photo?: string;
 };
 export declare function toUserLike(u: UserLikeInput | undefined): UserLike | undefined;
-/** Single filter value: text (string), multi-select (string[]), or people (UserLike). */
-export type FilterValue = string | string[] | UserLike;
+/** Single filter value: text (string), multi-select (string[]), people (UserLike), or date range. */
+export type FilterValue = string | string[] | UserLike | IDateFilterValue;
 /** Unified filter model: field id -> filter value. Use FilterValue for type-safe access. */
 export interface IFilters {
     [field: string]: FilterValue | undefined;
 }
-/** Split IFilters into DataGridTable's multiSelect, text, and people props. */
+/** Split IFilters into DataGridTable's multiSelect, text, people, and date props. */
 export declare function toDataGridFilterProps(filters: IFilters): {
     multiSelectFilters: Record<string, string[]>;
     textFilters: Record<string, string>;
     peopleFilters: Record<string, UserLike | undefined>;
+    dateFilters: Record<string, IDateFilterValue>;
 };
 export interface IFetchParams {
     page: number;
@@ -50,13 +51,19 @@ export interface IDataSource<T> {
     searchPeople?(query: string): Promise<UserLike[]>;
     getUserByEmail?(email: string): Promise<UserLike | undefined>;
 }
-/** Column state returned by getColumnState(). Uses string[] for JSON-serializability (e.g. column state persistence). */
+/** Column state returned by getColumnState(). All fields JSON-serializable for persistence (e.g. localStorage). */
 export interface IGridColumnState {
     visibleColumns: string[];
     sort?: {
         field: string;
         direction: 'asc' | 'desc';
     };
+    /** Column display order (array of column ids). */
+    columnOrder?: string[];
+    /** Column widths (column id -> width in pixels). */
+    columnWidths?: Record<string, number>;
+    /** Active filters. */
+    filters?: IFilters;
 }
 /** Row selection mode. */
 export type RowSelectionMode = 'none' | 'single' | 'multiple';
@@ -77,6 +84,14 @@ export interface IStatusBarProps {
     selectedCount?: number;
     /** Panels to show (default: all applicable). */
     panels?: StatusBarPanel[];
+    /** Aggregation values for selected numeric cells. */
+    aggregation?: {
+        sum: number;
+        avg: number;
+        min: number;
+        max: number;
+        count: number;
+    } | null;
 }
 /** Identifies a cell for keyboard navigation. */
 export interface IActiveCell {
@@ -94,14 +109,27 @@ export interface ISelectionRange {
 export declare function isInSelectionRange(range: ISelectionRange, row: number, col: number): boolean;
 /** Normalize range so start ≤ end for both dimensions. */
 export declare function normalizeSelectionRange(range: ISelectionRange): ISelectionRange;
+/** Available side bar panel identifiers. */
+export type SideBarPanelId = 'columns' | 'filters';
+/** Side bar configuration options. */
+export interface ISideBarDef {
+    /** Which panels to show (default: ['columns', 'filters']). */
+    panels?: SideBarPanelId[];
+    /** Panel to open on mount. */
+    defaultPanel?: SideBarPanelId;
+    /** Position of the side bar (default: 'right'). */
+    position?: 'left' | 'right';
+}
 /** Imperative grid API exposed via ref. */
 export interface IOGridApi<T> {
     /** Set row data (client-side only; no-op when using dataSource). */
     setRowData: (data: T[]) => void;
     /** Set loading overlay. */
     setLoading: (loading: boolean) => void;
-    /** Get current column state (visible columns, sort). */
+    /** Get current column state (visibility, order, widths, sort, filters). */
     getColumnState: () => IGridColumnState;
+    /** Bulk restore column state (visibility, order, widths, sort, filters). All fields optional. */
+    applyColumnState: (state: Partial<IGridColumnState>) => void;
     /** Set filter model (unified IFilters). */
     setFilterModel: (filters: IFilters) => void;
     /** Get currently selected row IDs. */
@@ -138,6 +166,8 @@ export interface IOGridProps<T> {
     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;
     freezeRows?: number;
     freezeCols?: number;
     editable?: boolean;
@@ -162,8 +192,20 @@ export interface IOGridProps<T> {
     };
     entityLabelPlural?: string;
     className?: string;
+    /** @deprecated Render your title outside the OGrid component. Will be removed in next major. */
     title?: ReactNode;
+    /** 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[];
     /** Called when server-side fetchPage fails. */
     onError?: (error: unknown) => void;
     'aria-label'?: string;
@@ -181,11 +223,17 @@ export interface IOGridDataGridProps<T> {
     /** 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;
+    /** 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;
@@ -206,6 +254,8 @@ export interface IOGridDataGridProps<T> {
     onTextFilterChange?: (key: string, value: string) => void;
     peopleFilters?: Record<string, UserLike | undefined>;
     onPeopleFilterChange?: (key: string, user: UserLike | undefined) => void;
+    dateFilters?: Record<string, IDateFilterValue>;
+    onDateFilterChange?: (key: string, value: IDateFilterValue | undefined) => void;
     filterOptions: Record<string, string[]>;
     loadingFilterOptions: Record<string, boolean>;
     peopleSearch?: (query: string) => Promise<UserLike[]>;

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

@@ -1,3 +1,3 @@
-export type { ColumnFilterType, IColumnFilterDef, IColumnMeta, IColumnDef, IColumnGroupDef, IColumnDefinition, ICellValueChangedEvent, ICellEditorProps, CellEditorParams, IValueParserParams, } from './columnTypes';
-export type { RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, IOGridProps, IOGridDataGridProps, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, } from './dataGridTypes';
+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, toDataGridFilterProps, isInSelectionRange, normalizeSelectionRange } from './dataGridTypes';

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

@@ -0,0 +1,15 @@
+import type { IColumnDef } from '../types/columnTypes';
+import type { ISelectionRange } from '../types/dataGridTypes';
+export interface AggregationResult {
+    sum: number;
+    avg: number;
+    min: number;
+    max: number;
+    count: number;
+}
+/**
+ * Computes numeric aggregations (sum, avg, min, max, count) for selected cells.
+ * Only numeric values are included in sum/avg/min/max. Count includes only numeric cells.
+ * Returns null when selection is absent, has fewer than 2 cells, or contains no numeric values.
+ */
+export declare function computeAggregations<T>(items: T[], visibleCols: IColumnDef<T>[], selectionRange: ISelectionRange | null): AggregationResult | null;

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

@@ -1,6 +1,21 @@
-import type { IColumnDef, IColumnGroupDef } from '../types/columnTypes';
+import type { IColumnDef, IColumnGroupDef, HeaderRow } from '../types/columnTypes';
 /**
  * Flattens a tree of column groups and column definitions into a single array of leaf columns.
  * Used for body rendering and when the grid accepts grouped columns.
  */
 export declare function flattenColumns<T>(columns: (IColumnGroupDef<T> | IColumnDef<T>)[]): IColumnDef<T>[];
+/**
+ * Builds an array of header rows from a column tree for multi-row <thead> rendering.
+ *
+ * - Flat columns (no groups) produce a single row of leaf cells.
+ * - Grouped columns produce N rows where N = max nesting depth + 1.
+ * - Group cells get colSpan = number of visible leaf descendants.
+ * - Leaf cells at a depth shallower than maxDepth are placed at their own depth
+ *   (the rendering layer can use rowSpan to stretch them down to the bottom row).
+ * - If visibleColumns is provided, only visible leaf columns and their ancestors are included.
+ *
+ * @param columns - The column tree (mix of IColumnDef and IColumnGroupDef)
+ * @param visibleColumns - Optional set of visible column ids (filters out hidden leaves + empty groups)
+ * @returns Array of HeaderRow, from top (group headers) to bottom (leaf columns)
+ */
+export declare function buildHeaderRows<T>(columns: (IColumnGroupDef<T> | IColumnDef<T>)[], visibleColumns?: Set<string>): HeaderRow<T>[];

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

@@ -1,7 +1,8 @@
 /**
  * View model helpers for DataGridTable. Core owns the logic; UI packages only render.
  */
-import type { ColumnFilterType } from '../types/columnTypes';
+import type * as React from 'react';
+import type { ColumnFilterType, ICellEditorProps, IDateFilterValue } from '../types/columnTypes';
 import type { IColumnDef } from '../types/columnTypes';
 import type { RowId, UserLike } from '../types/dataGridTypes';
 export interface HeaderFilterConfigInput {
@@ -17,6 +18,8 @@ export interface HeaderFilterConfigInput {
     loadingFilterOptions: Record<string, boolean>;
     multiSelectFilters: Record<string, string[]>;
     onMultiSelectFilterChange: (key: string, values: string[]) => void;
+    dateFilters?: Record<string, IDateFilterValue>;
+    onDateFilterChange?: (key: string, value: IDateFilterValue | undefined) => void;
 }
 /** Props to pass to ColumnHeaderFilter. Matches IColumnHeaderFilterProps. */
 export interface HeaderFilterConfig {
@@ -35,6 +38,8 @@ export interface HeaderFilterConfig {
     selectedUser?: UserLike;
     onUserChange?: (user: UserLike | undefined) => void;
     peopleSearch?: (query: string) => Promise<UserLike[]>;
+    dateValue?: IDateFilterValue;
+    onDateChange?: (value: IDateFilterValue | undefined) => void;
 }
 /**
  * Returns ColumnHeaderFilter props from column def and grid filter/sort state.
@@ -79,7 +84,7 @@ export interface CellRenderDescriptorInput<T> {
 }
 export interface CellRenderDescriptor {
     mode: CellRenderMode;
-    editorType?: 'text' | 'select' | 'checkbox';
+    editorType?: 'text' | 'select' | 'checkbox' | 'richSelect' | 'date';
     value?: unknown;
     isActive: boolean;
     isInRange: boolean;
@@ -100,3 +105,63 @@ export interface CellRenderDescriptor {
  * and to apply isActive, isInRange, etc. without duplicating the boolean logic.
  */
 export declare function getCellRenderDescriptor<T>(item: T, col: IColumnDef<T>, rowIndex: number, colIdx: number, input: CellRenderDescriptorInput<T>): CellRenderDescriptor;
+/**
+ * Resolves display content for a cell in display mode.
+ * Handles the renderCell → valueFormatter → String() fallback chain.
+ */
+export declare function resolveCellDisplayContent<T>(col: IColumnDef<T>, item: T, displayValue: unknown): React.ReactNode;
+/**
+ * Resolves the cellStyle from a column def, handling both function and static values.
+ */
+export declare function resolveCellStyle<T>(col: IColumnDef<T>, item: T): React.CSSProperties | undefined;
+/**
+ * Builds props for InlineCellEditor. Shared across all UI packages.
+ */
+export declare function buildInlineEditorProps<T>(item: T, col: IColumnDef<T>, descriptor: CellRenderDescriptor, callbacks: {
+    commitCellEdit: (item: T, columnId: string, oldValue: unknown, newValue: unknown, rowIndex: number, globalColIndex: number) => void;
+    setEditingCell: (cell: null) => void;
+}): {
+    value: unknown;
+    item: T;
+    column: IColumnDef<T>;
+    rowIndex: number;
+    editorType: "text" | "select" | "checkbox" | "richSelect" | "date";
+    onCommit: (newValue: unknown) => void;
+    onCancel: () => void;
+};
+/**
+ * Builds ICellEditorProps for custom popover editors. Shared across all UI packages.
+ */
+export declare function buildPopoverEditorProps<T>(item: T, col: IColumnDef<T>, descriptor: CellRenderDescriptor, pendingEditorValue: unknown, callbacks: {
+    setPendingEditorValue: (value: unknown) => void;
+    commitCellEdit: (item: T, columnId: string, oldValue: unknown, newValue: unknown, rowIndex: number, globalColIndex: number) => void;
+    cancelPopoverEdit: () => void;
+}): ICellEditorProps<T>;
+/**
+ * Common interaction props for cell wrapper elements.
+ * Includes data attributes, event handlers, and accessibility props.
+ * Spread onto the cell wrapper div/Box in each UI package.
+ */
+export interface CellInteractionHandlers {
+    handleCellMouseDown: (e: React.MouseEvent, rowIndex: number, colIndex: number) => void;
+    setActiveCell: (cell: {
+        rowIndex: number;
+        columnIndex: number;
+    }) => void;
+    setEditingCell: (cell: {
+        rowId: RowId;
+        columnId: string;
+    } | null) => void;
+    handleCellContextMenu: (e: React.MouseEvent) => void;
+}
+export declare function getCellInteractionProps(descriptor: CellRenderDescriptor, columnId: string, handlers: CellInteractionHandlers): {
+    role?: "button" | undefined;
+    onDoubleClick?: (() => void) | undefined;
+    tabIndex: number;
+    onMouseDown: (e: React.MouseEvent) => void;
+    onClick: () => void;
+    onContextMenu: (e: React.MouseEvent) => void;
+    'data-in-range'?: "true" | undefined;
+    'data-row-index': number;
+    'data-col-index': number;
+};

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

@@ -1,16 +1,18 @@
 export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, } from './exportToCsv';
 export { getCellValue } from './cellValue';
-export { flattenColumns } from './columnUtils';
+export { flattenColumns, buildHeaderRows } from './columnUtils';
 export { getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, } from './ogridHelpers';
 export { getStatusBarParts } from './statusBarHelpers';
 export { getDataGridStatusBarConfig } from './dataGridStatusBar';
 export { getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, } from './paginationHelpers';
 export type { PaginationViewModel } from './paginationHelpers';
 export { GRID_CONTEXT_MENU_ITEMS, getContextMenuHandlers, formatShortcut } from './gridContextMenuHelpers';
-export { getHeaderFilterConfig, getCellRenderDescriptor, } from './dataGridViewModel';
-export type { HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, } from './dataGridViewModel';
+export { getHeaderFilterConfig, getCellRenderDescriptor, resolveCellDisplayContent, resolveCellStyle, buildInlineEditorProps, buildPopoverEditorProps, getCellInteractionProps, } from './dataGridViewModel';
+export type { HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, CellInteractionHandlers, } from './dataGridViewModel';
 export type { CsvColumn } from './exportToCsv';
 export type { StatusBarPart, StatusBarPartsInput } from './statusBarHelpers';
 export type { GridContextMenuItem, GridContextMenuHandlerProps } from './gridContextMenuHelpers';
 export { parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, } from './valueParsers';
 export type { ParseValueResult } from './valueParsers';
+export { computeAggregations } from './aggregationUtils';
+export type { AggregationResult } from './aggregationUtils';

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

@@ -1,8 +1,8 @@
-import type { IColumnDef, UserLike, IFilters } from '../types';
+import type { IColumnDef, IFilters, FilterValue } from '../types';
 /** Resolve the filter field key for a column (filterField or columnId). */
 export declare function getFilterField<T>(col: IColumnDef<T>): string;
 /** Merge a single filter change into a full IFilters object. */
-export declare function mergeFilter(prev: IFilters, key: string, value: string | string[] | UserLike | undefined): IFilters;
+export declare function mergeFilter(prev: IFilters, key: string, value: FilterValue | undefined): IFilters;
 /** Derive filter options for multiSelect columns from client-side data. */
 export declare function deriveFilterOptionsFromData<T>(items: T[], columns: IColumnDef<T>[]): Record<string, string[]>;
 /** Get list of filter fields that use multiSelect (for useFilterOptions). */

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

@@ -2,7 +2,7 @@
  * Shared pagination view model for Fluent, Material, and Radix PaginationControls.
  * UI packages use this and render only presentation.
  */
-export declare const PAGE_SIZE_OPTIONS: readonly [10, 20, 50, 100];
+export declare const PAGE_SIZE_OPTIONS: readonly [10, 25, 50, 100];
 export declare const MAX_PAGE_BUTTONS = 5;
 export interface PaginationViewModel {
     totalPages: number;

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

@@ -11,6 +11,14 @@ export interface StatusBarPartsInput {
     filteredCount?: number;
     selectedCount?: number;
     selectedCellCount?: number;
+    /** Aggregation of selected numeric cells. */
+    aggregation?: {
+        sum: number;
+        avg: number;
+        min: number;
+        max: number;
+        count: number;
+    } | null;
 }
 /**
  * Returns an array of status bar parts (Rows, Filtered, Selected) for consistent rendering across packages.

package/package.json

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