@alaarab/ogrid-core 1.3.2 → 1.4.0

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.2",
+  "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",