@alaarab/ogrid-core 1.2.1 → 1.3.0

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

@@ -63,11 +63,19 @@ export interface CellRenderDescriptorInput<T> {
         endRow: number;
         endCol: number;
     } | null;
+    copyRange: {
+        startRow: number;
+        startCol: number;
+        endRow: number;
+        endCol: number;
+    } | null;
     colOffset: number;
     itemsLength: number;
     getRowId: (item: T) => RowId;
     editable?: boolean;
     onCellValueChanged?: (event: import('../types/columnTypes').ICellValueChangedEvent<T>) => void;
+    /** True while user is drag-selecting cells — hides fill handle during drag. */
+    isDragging?: boolean;
 }
 export interface CellRenderDescriptor {
     mode: CellRenderMode;
@@ -76,6 +84,7 @@ export interface CellRenderDescriptor {
     isActive: boolean;
     isInRange: boolean;
     isInCutRange: boolean;
+    isInCopyRange: boolean;
     isSelectionEndCell: boolean;
     canEditAny: boolean;
     isPinned: boolean;

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

@@ -4,16 +4,24 @@
 export interface GridContextMenuItem {
     id: string;
     label: string;
+    /** Keyboard shortcut text displayed in the menu (e.g. 'Ctrl+Z'). Ctrl is swapped to ⌘ on Mac at render time. */
+    shortcut?: string;
     /** When true, the item is disabled when there is no cell selection (e.g. Copy, Cut). */
     disabledWhenNoSelection?: boolean;
+    /** When true, a divider is rendered before this item. */
+    dividerBefore?: boolean;
 }
 export declare const GRID_CONTEXT_MENU_ITEMS: GridContextMenuItem[];
+/** Returns the shortcut string with Ctrl swapped to ⌘ on Mac. */
+export declare function formatShortcut(shortcut: string): string;
 /** Props passed to getContextMenuHandlers (callbacks + onClose). */
 export interface GridContextMenuHandlerProps {
     onCopy: () => void;
     onCut: () => void;
     onPaste: () => void;
     onSelectAll: () => void;
+    onUndo: () => void;
+    onRedo: () => void;
     onClose: () => void;
 }
 /**

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

@@ -6,9 +6,11 @@ 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 } from './gridContextMenuHelpers';
+export { GRID_CONTEXT_MENU_ITEMS, getContextMenuHandlers, formatShortcut } from './gridContextMenuHelpers';
 export { getHeaderFilterConfig, getCellRenderDescriptor, } from './dataGridViewModel';
 export type { HeaderFilterConfigInput, HeaderFilterConfig, CellRenderDescriptorInput, CellRenderDescriptor, CellRenderMode, } 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';

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

@@ -0,0 +1,37 @@
+import type { IColumnDef, IValueParserParams } from '../types/columnTypes';
+/**
+ * Result of parsing a cell value. When `valid` is false the change should be skipped.
+ */
+export interface ParseValueResult {
+    valid: boolean;
+    value: unknown;
+}
+/**
+ * Run the column's valueParser (if any), or auto-validate select columns.
+ * Returns `{ valid: true, value }` with the parsed value, or `{ valid: false }` to reject.
+ */
+export declare function parseValue<T>(newValue: unknown, oldValue: unknown, item: T, col: IColumnDef<T>): ParseValueResult;
+/**
+ * Parses a value as a number. Strips whitespace and commas.
+ * Returns `undefined` (reject) if result is NaN.
+ */
+export declare function numberParser<T>(params: IValueParserParams<T>): unknown;
+/**
+ * Parses a currency string. Strips currency symbols ($, €, £, ¥), whitespace, commas.
+ * Returns `undefined` (reject) if result is NaN.
+ */
+export declare function currencyParser<T>(params: IValueParserParams<T>): unknown;
+/**
+ * Parses a date string via `new Date()`. Returns ISO string or `undefined` if invalid.
+ */
+export declare function dateParser<T>(params: IValueParserParams<T>): unknown;
+/**
+ * Validates an email address with a basic regex.
+ * Returns the trimmed string or `undefined` if invalid.
+ */
+export declare function emailParser<T>(params: IValueParserParams<T>): unknown;
+/**
+ * Parses boolean-like values: true/false/yes/no/1/0.
+ * Returns `undefined` if not recognized.
+ */
+export declare function booleanParser<T>(params: IValueParserParams<T>): unknown;

package/package.json

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