@alaarab/ogrid-core 1.8.2 → 1.9.0

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

@@ -149,13 +149,23 @@ export interface IOGridApi<T> {
     selectAll: () => void;
     /** Deselect all rows. */
     deselectAll: () => void;
+    /** 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;
+    /** Get the currently displayed (paginated) rows. */
+    getDisplayedRows: () => T[];
+    /** Re-trigger a data fetch (server-side only; no-op for client-side). */
+    refreshData: () => void;
 }
-/** Props for the OGrid wrapper component (shared across Fluent, Material, Radix). */
-export interface IOGridProps<T> {
+/** Base props shared by both client-side and server-side OGrid modes. */
+interface IOGridBaseProps<T> {
     columns: (IColumnDef<T> | IColumnGroupDef<T>)[];
     getRowId: (item: T) => RowId;
-    data?: T[];
-    dataSource?: IDataSource<T>;
     page?: number;
     pageSize?: number;
     sort?: {
@@ -221,9 +231,24 @@ export interface IOGridProps<T> {
     onFirstDataRendered?: () => void;
     /** Called when server-side fetchPage fails. */
     onError?: (error: unknown) => void;
+    /** Called when a cell renderer or custom editor throws an error. */
+    onCellError?: (error: Error, errorInfo: React.ErrorInfo) => void;
     'aria-label'?: string;
     'aria-labelledby'?: string;
 }
+/** Client-side mode: pass a data array. */
+export interface IOGridClientProps<T> extends IOGridBaseProps<T> {
+    data: T[];
+    dataSource?: never;
+}
+/** Server-side mode: pass a dataSource. */
+export interface IOGridServerProps<T> extends IOGridBaseProps<T> {
+    data?: never;
+    dataSource: IDataSource<T>;
+}
+/** Props for the OGrid wrapper component (shared across Fluent, Material, Radix).
+ *  Must provide either `data` (client-side) or `dataSource` (server-side), not both. */
+export type IOGridProps<T> = IOGridClientProps<T> | IOGridServerProps<T>;
 /** Props passed from useOGrid to the framework-specific DataGridTable. */
 export interface IOGridDataGridProps<T> {
     items: T[];
@@ -279,6 +304,9 @@ export interface IOGridDataGridProps<T> {
         message?: ReactNode;
         render?: () => ReactNode;
     };
+    /** Called when a cell renderer or custom editor throws an error. */
+    onCellError?: (error: Error, errorInfo: React.ErrorInfo) => void;
     'aria-label'?: string;
     'aria-labelledby'?: string;
 }
+export {};

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 type { RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, IOGridProps, IOGridClientProps, IOGridServerProps, IOGridDataGridProps, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, SideBarPanelId, ISideBarDef, } from './dataGridTypes';
 export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './dataGridTypes';

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

@@ -0,0 +1,49 @@
+/**
+ * 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;

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

@@ -17,3 +17,5 @@ export type { ParseValueResult } from './valueParsers';
 export { computeAggregations } from './aggregationUtils';
 export type { AggregationResult } from './aggregationUtils';
 export { processClientSideData } from './clientSideData';
+export { areGridRowPropsEqual } from './gridRowComparator';
+export type { GridRowComparatorProps } from './gridRowComparator';

package/package.json

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