@alaarab/ogrid-core 1.9.0 → 2.0.0

package/README.md

@@ -1,11 +1,10 @@
 <p align="center">
-  <strong>OGrid Core</strong> — Headless types, hooks, and utilities for OGrid data grids.
+  <strong>OGrid Core</strong> — Pure TypeScript types, algorithms, and utilities for OGrid data grids.
 </p>
 
 <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/React-17%20%7C%2018%20%7C%2019-blue" alt="React 17, 18, 19" />
   <img src="https://img.shields.io/badge/TypeScript-strict-blue" alt="TypeScript strict" />
 </p>
 
@@ -15,20 +14,11 @@
 
 ---
 
-Framework-agnostic foundation for [OGrid](https://github.com/alaarab/ogrid) data grids. You typically don't need to install this directly — the UI packages ([`@alaarab/ogrid`](https://www.npmjs.com/package/@alaarab/ogrid), [`@alaarab/ogrid-fluent`](https://www.npmjs.com/package/@alaarab/ogrid-fluent), [`@alaarab/ogrid-material`](https://www.npmjs.com/package/@alaarab/ogrid-material)) re-export everything from 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).
 
-## What's Inside
-
-### Hooks
+You typically don't need to install this directly — the UI packages re-export everything from core.
 
-- `useOGrid` — Orchestrator: pagination, sorting, filtering, visibility, editing, row selection, status bar, grid API
-- `useDataGridState` — All DataGridTable state: layout, selection, editing, interaction, context menu, view models
-- `useColumnHeaderFilterState` — Filter popover (open, temp values, apply/clear, people search debounce)
-- `useColumnChooserState` — Column visibility dropdown
-- `useInlineCellEditorState` — Inline cell editor
-- `useRichSelectState` — Searchable rich select dropdown
-- `useSideBarState` — Side bar panel management
-- `useActiveCell`, `useCellSelection`, `useCellEditing`, `useRowSelection`, `useKeyboardNavigation`, `useClipboard`, `useFillHandle`, `useUndoRedo`, `useContextMenu`, `useColumnResize`, `useFilterOptions`, `useDebounce`
+## What's Inside
 
 ### Types
 
@@ -36,11 +26,7 @@ Framework-agnostic foundation for [OGrid](https://github.com/alaarab/ogrid) data
 
 ### Utilities
 
-`processClientSideData` · `exportToCsv` · `getCellValue` · `flattenColumns` · `buildHeaderRows` · `getPaginationViewModel` · `getHeaderFilterConfig` · `getCellRenderDescriptor` · `computeAggregations` · `formatShortcut` · `GRID_CONTEXT_MENU_ITEMS`
-
-### Headless Components
-
-`OGridLayout` · `StatusBar` · `GridContextMenu` · `SideBar` · `MarchingAntsOverlay`
+`getCellValue` · `buildHeaderRows` · `parseValue` · `normalizeSelectionRange` · `isInSelectionRange` · `toUserLike`
 
 ## Install
 
@@ -48,7 +34,7 @@ Framework-agnostic foundation for [OGrid](https://github.com/alaarab/ogrid) data
 npm install @alaarab/ogrid-core
 ```
 
-Only peer dep is `react ^17 || ^18 || ^19`.
+No peer dependencies. No framework dependencies.
 
 ## Documentation
 

package/dist/esm/index.js

@@ -1,16 +1,6 @@
+// Types
+export * from './types';
+// Utils
+export * from './utils';
 // Constants
-export { CHECKBOX_COLUMN_WIDTH, DEFAULT_MIN_COLUMN_WIDTH, CELL_PADDING, GRID_BORDER_RADIUS, } from './constants';
-export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './types';
-// Hooks
-export { useFilterOptions, useOGrid, useActiveCell, useCellEditing, useContextMenu, useCellSelection, useClipboard, useRowSelection, useKeyboardNavigation, useUndoRedo, useDebounce, useFillHandle, useDataGridState, useColumnHeaderFilterState, useTextFilterState, useMultiSelectFilterState, usePeopleFilterState, useDateFilterState, useColumnChooserState, useInlineCellEditorState, useColumnResize, useRichSelectState, useSideBarState, useTableLayout, useLatestRef, } from './hooks';
-// Components
-export { OGridLayout } from './components/OGridLayout';
-export { StatusBar } from './components/StatusBar';
-export { BaseInlineCellEditor, editorWrapperStyle, editorInputStyle, richSelectWrapperStyle, richSelectDropdownStyle, richSelectOptionStyle, richSelectOptionHighlightedStyle, richSelectNoMatchesStyle, selectEditorStyle, } from './components/BaseInlineCellEditor';
-export { GridContextMenu } from './components/GridContextMenu';
-export { MarchingAntsOverlay } from './components/MarchingAntsOverlay';
-export { SideBar } from './components/SideBar';
-export { CellErrorBoundary } from './components/CellErrorBoundary';
-export { EmptyState } from './components/EmptyState';
-// 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, areGridRowPropsEqual, } from './utils';
+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

@@ -60,7 +60,7 @@ export function processClientSideData(data, columns, filters, sortBy, sortDirect
             }
         }
     }
-    let rows = predicates.length > 0
+    const rows = predicates.length > 0
         ? data.filter((row) => {
             for (let i = 0; i < predicates.length; i++) {
                 if (!predicates[i](row))

package/dist/esm/utils/gridRowComparator.js

@@ -1,4 +1,14 @@
-import { isRowInRange } from './dataGridViewModel';
+/**
+ * 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.

package/dist/esm/utils/index.js

@@ -6,8 +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 } from './gridRowComparator';
+export { areGridRowPropsEqual, isRowInRange } from './gridRowComparator';

package/dist/types/index.d.ts

@@ -1,23 +1,3 @@
-export { CHECKBOX_COLUMN_WIDTH, DEFAULT_MIN_COLUMN_WIDTH, CELL_PADDING, GRID_BORDER_RADIUS, } from './constants';
-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, useTextFilterState, useMultiSelectFilterState, usePeopleFilterState, useDateFilterState, useColumnChooserState, useInlineCellEditorState, useColumnResize, useRichSelectState, useSideBarState, useTableLayout, useLatestRef, } from './hooks';
-export type { UseFilterOptionsResult, UseOGridResult, UseOGridPagination, UseOGridColumnChooser, UseOGridLayout, UseOGridFilters, 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, UseTextFilterStateParams, UseTextFilterStateResult, UseMultiSelectFilterStateParams, UseMultiSelectFilterStateResult, UsePeopleFilterStateParams, UsePeopleFilterStateResult, UseDateFilterStateParams, UseDateFilterStateResult, UseColumnChooserStateParams, UseColumnChooserStateResult, UseInlineCellEditorStateParams, UseInlineCellEditorStateResult, InlineCellEditorType, UseColumnResizeParams, UseColumnResizeResult, UseRichSelectStateParams, UseRichSelectStateResult, UseSideBarStateParams, UseSideBarStateResult, UseTableLayoutParams, UseTableLayoutResult, } 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 { BaseInlineCellEditor, editorWrapperStyle, editorInputStyle, richSelectWrapperStyle, richSelectDropdownStyle, richSelectOptionStyle, richSelectOptionHighlightedStyle, richSelectNoMatchesStyle, selectEditorStyle, } from './components/BaseInlineCellEditor';
-export type { BaseInlineCellEditorProps } from './components/BaseInlineCellEditor';
-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 { CellErrorBoundary } from './components/CellErrorBoundary';
-export type { CellErrorBoundaryProps } from './components/CellErrorBoundary';
-export { EmptyState } from './components/EmptyState';
-export type { EmptyStateProps } from './components/EmptyState';
-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, areGridRowPropsEqual, } from './utils';
-export type { CsvColumn, StatusBarPart, StatusBarPartsInput, GridContextMenuItem, GridContextMenuHandlerProps, PaginationViewModel, HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, CellInteractionHandlers, ParseValueResult, AggregationResult, GridRowComparatorProps, } 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). */

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 {
@@ -162,151 +161,3 @@ export interface IOGridApi<T> {
     /** Re-trigger a data fetch (server-side only; no-op for client-side). */
     refreshData: () => void;
 }
-/** Base props shared by both client-side and server-side OGrid modes. */
-interface IOGridBaseProps<T> {
-    columns: (IColumnDef<T> | IColumnGroupDef<T>)[];
-    getRowId: (item: T) => RowId;
-    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';
-    }) => 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;
-    /** 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[];
-    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;
-    };
-    /** 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, IOGridClientProps, IOGridServerProps, 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

@@ -1,3 +1,11 @@
+/**
+ * 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.

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

@@ -7,8 +7,6 @@ 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, isRowInRange, 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';
@@ -17,5 +15,5 @@ export type { ParseValueResult } from './valueParsers';
 export { computeAggregations } from './aggregationUtils';
 export type { AggregationResult } from './aggregationUtils';
 export { processClientSideData } from './clientSideData';
-export { areGridRowPropsEqual } from './gridRowComparator';
+export { areGridRowPropsEqual, isRowInRange } from './gridRowComparator';
 export type { GridRowComparatorProps } from './gridRowComparator';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alaarab/ogrid-core",
-  "version": "1.9.0",
-  "description": "OGrid core – framework-agnostic types, hooks, and utilities for OGrid data tables.",
+  "version": "2.0.0",
+  "description": "OGrid core – framework-agnostic types, algorithms, and utilities for OGrid data grids.",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -16,28 +16,10 @@
     "build": "rimraf dist && tsc -p tsconfig.build.json",
     "test": "jest"
   },
-  "keywords": [
-    "ogrid",
-    "datatable",
-    "react",
-    "typescript",
-    "grid",
-    "core"
-  ],
+  "keywords": ["ogrid", "datatable", "typescript", "grid", "core"],
   "author": "Ala Arab",
   "license": "MIT",
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "peerDependencies": {
-    "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": { "node": ">=18" },
+  "publishConfig": { "access": "public" }
 }

package/dist/esm/components/BaseInlineCellEditor.js

@@ -1,112 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import * as React from 'react';
-import { useInlineCellEditorState, useRichSelectState } from '../hooks';
-// ── Shared editor style constants (used across all 3 UI packages) ──
-export const editorWrapperStyle = {
-    width: '100%',
-    height: '100%',
-    display: 'flex',
-    alignItems: 'center',
-    padding: '6px 10px',
-    boxSizing: 'border-box',
-    overflow: 'hidden',
-    minWidth: 0,
-};
-export const editorInputStyle = {
-    width: '100%',
-    padding: 0,
-    border: 'none',
-    background: 'transparent',
-    color: 'inherit',
-    font: 'inherit',
-    fontSize: '13px',
-    outline: 'none',
-    minWidth: 0,
-};
-export const richSelectWrapperStyle = {
-    ...editorWrapperStyle,
-    position: 'relative',
-};
-export const richSelectDropdownStyle = {
-    position: 'absolute',
-    top: '100%',
-    left: 0,
-    right: 0,
-    maxHeight: 200,
-    overflowY: 'auto',
-    background: 'var(--ogrid-bg, #fff)',
-    border: '1px solid var(--ogrid-border, #ccc)',
-    zIndex: 10,
-    boxShadow: '0 4px 16px rgba(0,0,0,0.2)',
-};
-export const richSelectOptionStyle = {
-    padding: '6px 8px',
-    cursor: 'pointer',
-    color: 'var(--ogrid-fg, #242424)',
-};
-export const richSelectOptionHighlightedStyle = {
-    ...richSelectOptionStyle,
-    background: 'var(--ogrid-bg-hover, #e8f0fe)',
-};
-export const richSelectNoMatchesStyle = {
-    padding: '6px 8px',
-    color: 'var(--ogrid-muted, #999)',
-};
-export const selectEditorStyle = {
-    width: '100%',
-    padding: 0,
-    border: 'none',
-    background: 'transparent',
-    color: 'inherit',
-    font: 'inherit',
-    fontSize: '13px',
-    cursor: 'pointer',
-    outline: 'none',
-};
-/**
- * Base inline cell editor with shared logic for all editor types except checkbox and select
- * (which are framework-specific). Used by all 3 UI packages to avoid duplication.
- *
- * Usage:
- * - Radix: Pass Radix Checkbox/native select via render props
- * - Fluent: Pass Fluent Checkbox/Select via render props
- * - Material: Pass MUI Checkbox/Select via render props
- */
-export function BaseInlineCellEditor(props) {
-    const { value, column, editorType, onCommit, onCancel, renderCheckbox, renderSelect } = props;
-    const wrapperRef = React.useRef(null);
-    const { localValue, setLocalValue, handleKeyDown, handleBlur, commit, cancel } = useInlineCellEditorState({ value, editorType, onCommit, onCancel });
-    const richSelectValues = column.cellEditorParams?.values ?? [];
-    const richSelectFormatValue = column.cellEditorParams?.formatValue;
-    const richSelect = useRichSelectState({
-        values: richSelectValues,
-        formatValue: richSelectFormatValue,
-        initialValue: value,
-        onCommit,
-        onCancel,
-    });
-    React.useEffect(() => {
-        const input = wrapperRef.current?.querySelector('input');
-        input?.focus();
-    }, []);
-    // Rich select (shared across all frameworks)
-    if (editorType === 'richSelect') {
-        return (_jsxs("div", { ref: wrapperRef, style: richSelectWrapperStyle, children: [_jsx("input", { type: "text", value: richSelect.searchText, onChange: (e) => richSelect.setSearchText(e.target.value), onKeyDown: richSelect.handleKeyDown, placeholder: "Search...", autoFocus: true, style: editorInputStyle }), _jsxs("div", { style: richSelectDropdownStyle, role: "listbox", children: [richSelect.filteredValues.map((v, i) => (_jsx("div", { role: "option", "aria-selected": i === richSelect.highlightedIndex, onClick: () => richSelect.selectValue(v), style: i === richSelect.highlightedIndex ? richSelectOptionHighlightedStyle : richSelectOptionStyle, children: richSelect.getDisplayText(v) }, String(v)))), richSelect.filteredValues.length === 0 && (_jsx("div", { style: richSelectNoMatchesStyle, children: "No matches" }))] })] }));
-    }
-    // Checkbox (framework-specific)
-    if (editorType === 'checkbox') {
-        const checked = value === true;
-        return _jsx(_Fragment, { children: renderCheckbox(checked, (val) => commit(val), cancel) });
-    }
-    // Select (framework-specific)
-    if (editorType === 'select') {
-        const values = column.cellEditorParams?.values ?? [];
-        return _jsx(_Fragment, { children: renderSelect(value, values, commit, cancel) });
-    }
-    // Date editor (shared across all frameworks)
-    if (editorType === 'date') {
-        return (_jsx("div", { ref: wrapperRef, style: editorWrapperStyle, children: _jsx("input", { type: "date", value: localValue, onChange: (e) => setLocalValue(e.target.value), onBlur: handleBlur, onKeyDown: handleKeyDown, style: editorInputStyle, autoFocus: true }) }));
-    }
-    // Text editor (default, shared across all frameworks)
-    return (_jsx("div", { ref: wrapperRef, style: editorWrapperStyle, children: _jsx("input", { type: "text", value: localValue, onChange: (e) => setLocalValue(e.target.value), onBlur: handleBlur, onKeyDown: handleKeyDown, style: editorInputStyle, autoFocus: true }) }));
-}

package/dist/esm/components/CellErrorBoundary.js

@@ -1,43 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import * as React from 'react';
-const DEFAULT_FALLBACK_STYLE = {
-    color: '#d32f2f',
-    fontSize: '0.75rem',
-    padding: '2px 4px',
-};
-/**
- * Error boundary for cell renderers and custom editors.
- * Prevents a runtime error in a cell from crashing the entire grid.
- */
-export class CellErrorBoundary extends React.Component {
-    constructor(props) {
-        super(props);
-        this.state = { hasError: false };
-    }
-    static getDerivedStateFromError() {
-        return { hasError: true };
-    }
-    componentDidCatch(error, errorInfo) {
-        if (this.props.onError) {
-            this.props.onError(error, errorInfo);
-        }
-    }
-    componentDidUpdate(prevProps) {
-        // Reset error state when children change (e.g., navigating to a different cell)
-        if (prevProps.children !== this.props.children && this.state.hasError) {
-            this.setState({ hasError: false });
-        }
-    }
-    resetErrorBoundary() {
-        this.setState({ hasError: false });
-    }
-    render() {
-        if (this.state.hasError) {
-            if (this.props.fallback !== undefined) {
-                return this.props.fallback;
-            }
-            return _jsx("span", { style: DEFAULT_FALLBACK_STYLE, children: "\u26A0 Error" });
-        }
-        return this.props.children;
-    }
-}

package/dist/esm/components/EmptyState.js

@@ -1,19 +0,0 @@
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-const clearButtonStyle = { background: 'none', border: 'none', color: 'inherit', textDecoration: 'underline', cursor: 'pointer', padding: 0, font: 'inherit' };
-/**
- * Headless empty state component with default rendering logic.
- * Framework-specific wrappers provide styling.
- *
- * Default behavior:
- * - Shows "No results found" title
- * - If hasActiveFilters=true: shows "clear all filters" link
- * - If message provided: shows custom message
- * - If render provided: uses custom renderer
- */
-export function EmptyState(props) {
-    const { message, hasActiveFilters, onClearAll, render } = props;
-    if (render) {
-        return _jsx(_Fragment, { children: render() });
-    }
-    return (_jsx(_Fragment, { children: message != null ? (message) : hasActiveFilters ? (_jsxs(_Fragment, { children: ["No items match your current filters. Try adjusting your search or", ' ', _jsx("button", { type: "button", onClick: onClearAll, style: clearButtonStyle, children: "clear all filters" }), ' ', "to see all items."] })) : ('There are no items available at this time.') }));
-}

package/dist/esm/components/GridContextMenu.js

@@ -1,35 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import * as React from 'react';
-import { GRID_CONTEXT_MENU_ITEMS, getContextMenuHandlers, formatShortcut } from '../utils/gridContextMenuHelpers';
-const menuPositionStyle = (x, y) => ({ left: x, top: y });
-export function GridContextMenu(props) {
-    const { x, y, hasSelection, canUndo, canRedo, onClose, onCopy, onCut, onPaste, onSelectAll, onUndo, onRedo, classNames } = props;
-    const ref = React.useRef(null);
-    const handlers = React.useMemo(() => getContextMenuHandlers({ onCopy, onCut, onPaste, onSelectAll, onUndo, onRedo, onClose }), [onCopy, onCut, onPaste, onSelectAll, onUndo, onRedo, onClose]);
-    const isDisabled = React.useCallback((item) => {
-        if (item.disabledWhenNoSelection && !hasSelection)
-            return true;
-        if (item.id === 'undo' && !canUndo)
-            return true;
-        if (item.id === 'redo' && !canRedo)
-            return true;
-        return false;
-    }, [hasSelection, canUndo, canRedo]);
-    React.useEffect(() => {
-        const handleClickOutside = (e) => {
-            if (ref.current && !ref.current.contains(e.target))
-                onClose();
-        };
-        const handleKeyDown = (e) => {
-            if (e.key === 'Escape')
-                onClose();
-        };
-        document.addEventListener('mousedown', handleClickOutside, true);
-        document.addEventListener('keydown', handleKeyDown, true);
-        return () => {
-            document.removeEventListener('mousedown', handleClickOutside, true);
-            document.removeEventListener('keydown', handleKeyDown, true);
-        };
-    }, [onClose]);
-    return (_jsx("div", { ref: ref, className: classNames?.contextMenu, role: "menu", style: menuPositionStyle(x, y), "aria-label": "Grid context menu", children: GRID_CONTEXT_MENU_ITEMS.map((item) => (_jsxs(React.Fragment, { children: [item.dividerBefore && _jsx("div", { className: classNames?.contextMenuDivider }), _jsxs("button", { type: "button", className: classNames?.contextMenuItem, onClick: handlers[item.id], disabled: isDisabled(item), children: [_jsx("span", { className: classNames?.contextMenuItemLabel, children: item.label }), item.shortcut && (_jsx("span", { className: classNames?.contextMenuItemShortcut, children: formatShortcut(item.shortcut) }))] })] }, item.id))) }));
-}