@alaarab/ogrid-core 1.2.0 → 1.2.2

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

@@ -1,4 +1,4 @@
-import type { IActiveCell } from '../types';
+import type { IActiveCell, RowId } from '../types';
 export interface UseActiveCellResult {
     activeCell: IActiveCell | null;
     setActiveCell: (cell: IActiveCell | null) => void;
@@ -8,6 +8,6 @@ export interface UseActiveCellResult {
  * When wrapperRef and editingCell are provided, scrolls the active cell into view when it changes (and not editing).
  */
 export declare function useActiveCell(wrapperRef?: React.RefObject<HTMLElement | null>, editingCell?: {
-    rowId: string;
+    rowId: RowId;
     columnId: string;
 } | null): UseActiveCellResult;

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

@@ -1,5 +1,6 @@
+import type { RowId } from '../types';
 export interface EditingCell {
-    rowId: string;
+    rowId: RowId;
     columnId: string;
 }
 export interface UseCellEditingResult {

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

@@ -1,6 +1,6 @@
 import type { RefObject } from 'react';
 import type { HeaderFilterConfigInput, CellRenderDescriptorInput } from '../utils';
-import type { IOGridDataGridProps, IStatusBarProps, IColumnDef } from '../types';
+import type { RowId, IOGridDataGridProps, IStatusBarProps, IColumnDef } from '../types';
 export interface UseDataGridStateParams<T> {
     props: IOGridDataGridProps<T>;
     wrapperRef: RefObject<HTMLDivElement | null>;
@@ -12,19 +12,19 @@ export interface UseDataGridStateResult<T> {
     totalColCount: number;
     colOffset: number;
     hasCheckboxCol: boolean;
-    rowIndexByRowId: Map<string, number>;
-    selectedRowIds: Set<string>;
-    updateSelection: (newSelectedIds: Set<string>) => void;
-    handleRowCheckboxChange: (rowId: string, checked: boolean, rowIndex: number, shiftKey: boolean) => void;
+    rowIndexByRowId: Map<RowId, number>;
+    selectedRowIds: Set<RowId>;
+    updateSelection: (newSelectedIds: Set<RowId>) => void;
+    handleRowCheckboxChange: (rowId: RowId, checked: boolean, rowIndex: number, shiftKey: boolean) => void;
     handleSelectAll: (checked: boolean) => void;
     allSelected: boolean;
     someSelected: boolean;
     editingCell: {
-        rowId: string;
+        rowId: RowId;
         columnId: string;
     } | null;
     setEditingCell: (cell: {
-        rowId: string;
+        rowId: RowId;
         columnId: string;
     } | null) => void;
     pendingEditorValue: unknown;

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

@@ -1,4 +1,4 @@
-import type { IActiveCell, ISelectionRange, IColumnDef, ICellValueChangedEvent, RowSelectionMode } from '../types';
+import type { RowId, IActiveCell, ISelectionRange, IColumnDef, ICellValueChangedEvent, RowSelectionMode } from '../types';
 import type { EditingCell } from './useCellEditing';
 import type { ContextMenuPosition } from './useContextMenu';
 export interface UseKeyboardNavigationParams<T> {
@@ -13,12 +13,12 @@ export interface UseKeyboardNavigationParams<T> {
     setSelectionRange: (range: ISelectionRange | null) => void;
     editable: boolean | undefined;
     onCellValueChanged: ((event: ICellValueChangedEvent<T>) => void) | undefined;
-    getRowId: (item: T) => string;
+    getRowId: (item: T) => RowId;
     editingCell: EditingCell | null;
     setEditingCell: (cell: EditingCell | null) => void;
     rowSelection: RowSelectionMode;
-    selectedRowIds: Set<string>;
-    handleRowCheckboxChange: (rowId: string, checked: boolean, rowIndex: number, shiftKey: boolean) => void;
+    selectedRowIds: Set<RowId>;
+    handleRowCheckboxChange: (rowId: RowId, checked: boolean, rowIndex: number, shiftKey: boolean) => void;
     handleCopy: () => void;
     handleCut: () => void;
     handlePaste: () => Promise<void>;

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

@@ -1,15 +1,15 @@
-import type { RowSelectionMode, IRowSelectionChangeEvent } from '../types';
+import type { RowId, RowSelectionMode, IRowSelectionChangeEvent } from '../types';
 export interface UseRowSelectionParams<T> {
     items: T[];
-    getRowId: (item: T) => string;
+    getRowId: (item: T) => RowId;
     rowSelection: RowSelectionMode;
-    controlledSelectedRows: Set<string> | undefined;
+    controlledSelectedRows: Set<RowId> | undefined;
     onSelectionChange: ((event: IRowSelectionChangeEvent<T>) => void) | undefined;
 }
 export interface UseRowSelectionResult {
-    selectedRowIds: Set<string>;
-    updateSelection: (newSelectedIds: Set<string>) => void;
-    handleRowCheckboxChange: (rowId: string, checked: boolean, rowIndex: number, shiftKey: boolean) => void;
+    selectedRowIds: Set<RowId>;
+    updateSelection: (newSelectedIds: Set<RowId>) => void;
+    handleRowCheckboxChange: (rowId: RowId, checked: boolean, rowIndex: number, shiftKey: boolean) => void;
     handleSelectAll: (checked: boolean) => void;
     allSelected: boolean;
     someSelected: boolean;

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

@@ -1,5 +1,7 @@
 import type { ReactNode } from 'react';
 import type { IColumnDef, IColumnGroupDef, ICellValueChangedEvent } from './columnTypes';
+/** Row identifier type — grids accept string or number IDs. */
+export type RowId = string | number;
 export interface UserLike {
     id?: string;
     displayName: string;
@@ -58,9 +60,9 @@ export interface IGridColumnState {
 }
 /** Row selection mode. */
 export type RowSelectionMode = 'none' | 'single' | 'multiple';
-/** Event payload when row selection changes. Uses string[] for JSON-serializability. */
+/** Event payload when row selection changes. */
 export interface IRowSelectionChangeEvent<T> {
-    selectedRowIds: string[];
+    selectedRowIds: RowId[];
     selectedItems: T[];
 }
 /** Status bar panel definition. */
@@ -103,9 +105,9 @@ export interface IOGridApi<T> {
     /** Set filter model (unified IFilters). */
     setFilterModel: (filters: IFilters) => void;
     /** Get currently selected row IDs. */
-    getSelectedRows: () => string[];
+    getSelectedRows: () => RowId[];
     /** Set selected row IDs programmatically. */
-    setSelectedRows: (rowIds: string[]) => void;
+    setSelectedRows: (rowIds: RowId[]) => void;
     /** Select all rows. */
     selectAll: () => void;
     /** Deselect all rows. */
@@ -114,7 +116,7 @@ export interface IOGridApi<T> {
 /** Props for the OGrid wrapper component (shared across Fluent, Material, Radix). */
 export interface IOGridProps<T> {
     columns: (IColumnDef<T> | IColumnGroupDef<T>)[];
-    getRowId: (item: T) => string;
+    getRowId: (item: T) => RowId;
     data?: T[];
     dataSource?: IDataSource<T>;
     page?: number;
@@ -143,7 +145,7 @@ export interface IOGridProps<T> {
     onUndo?: () => void;
     onRedo?: () => void;
     rowSelection?: RowSelectionMode;
-    selectedRows?: Set<string>;
+    selectedRows?: Set<RowId>;
     onSelectionChange?: (event: IRowSelectionChangeEvent<T>) => void;
     statusBar?: boolean | IStatusBarProps;
     defaultPageSize?: number;
@@ -167,8 +169,8 @@ export interface IOGridProps<T> {
 export interface IOGridDataGridProps<T> {
     items: T[];
     columns: (IColumnDef<T> | IColumnGroupDef<T>)[];
-    getRowId: (item: T) => string;
-    sortBy: string;
+    getRowId: (item: T) => RowId;
+    sortBy?: string;
     sortDirection: 'asc' | 'desc';
     onColumnSort: (columnKey: string) => void;
     visibleColumns: Set<string>;
@@ -187,7 +189,7 @@ export interface IOGridDataGridProps<T> {
     onUndo?: () => void;
     onRedo?: () => void;
     rowSelection?: RowSelectionMode;
-    selectedRows?: Set<string>;
+    selectedRows?: Set<RowId>;
     onSelectionChange?: (event: IRowSelectionChangeEvent<T>) => void;
     statusBar?: IStatusBarProps;
     multiSelectFilters: Record<string, string[]>;

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

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

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

@@ -3,9 +3,9 @@
  */
 import type { ColumnFilterType } from '../types/columnTypes';
 import type { IColumnDef } from '../types/columnTypes';
-import type { UserLike } from '../types/dataGridTypes';
+import type { RowId, UserLike } from '../types/dataGridTypes';
 export interface HeaderFilterConfigInput {
-    sortBy: string;
+    sortBy?: string;
     sortDirection: 'asc' | 'desc';
     onColumnSort: (columnKey: string) => void;
     textFilters?: Record<string, string>;
@@ -44,7 +44,7 @@ export declare function getHeaderFilterConfig<T>(col: IColumnDef<T>, input: Head
 export type CellRenderMode = 'editing-inline' | 'editing-popover' | 'display';
 export interface CellRenderDescriptorInput<T> {
     editingCell: {
-        rowId: string;
+        rowId: RowId;
         columnId: string;
     } | null;
     activeCell: {
@@ -65,7 +65,7 @@ export interface CellRenderDescriptorInput<T> {
     } | null;
     colOffset: number;
     itemsLength: number;
-    getRowId: (item: T) => string;
+    getRowId: (item: T) => RowId;
     editable?: boolean;
     onCellValueChanged?: (event: import('../types/columnTypes').ICellValueChangedEvent<T>) => void;
 }
@@ -81,7 +81,7 @@ export interface CellRenderDescriptor {
     isPinned: boolean;
     pinnedSide?: 'left' | 'right';
     globalColIndex: number;
-    rowId: string;
+    rowId: RowId;
     rowIndex: number;
     /** Raw value for display (when mode === 'display'). UI uses col.renderCell or col.valueFormatter. */
     displayValue?: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-core",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "OGrid core – framework-agnostic types, hooks, and utilities for OGrid data tables.",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",
@@ -16,10 +16,21 @@
     "build": "rimraf dist && tsc -p tsconfig.build.json",
     "test": "jest"
   },
-  "keywords": ["ogrid", "datatable", "react", "typescript", "grid", "core"],
+  "keywords": [
+    "ogrid",
+    "datatable",
+    "react",
+    "typescript",
+    "grid",
+    "core"
+  ],
   "author": "Ala Arab",
   "license": "MIT",
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "engines": {
     "node": ">=18"
   },