@alaarab/ogrid-angular 2.4.2 → 2.5.1

package/dist/types/components/base-datagrid-table.component.d.ts

@@ -128,6 +128,7 @@ export declare abstract class BaseDataGridTableComponent<T = unknown> {
         isDragging: boolean;
         getFormulaValue?: (col: number, row: number) => unknown;
         hasFormula?: (col: number, row: number) => boolean;
+        getFormula?: (col: number, row: number) => string | undefined;
         formulaVersion?: number;
     }>;
     readonly pinnedColumnsMap: import("@angular/core").Signal<Record<string, "left" | "right">>;
@@ -203,7 +204,7 @@ export declare abstract class BaseDataGridTableComponent<T = unknown> {
     /**
      * Returns derived cell interaction metadata (non-event attributes) for use in templates.
      * Mirrors React's getCellInteractionProps for the Angular view layer.
-     * Event handlers (mousedown, click, dblclick, contextmenu) are still bound inline in templates.
+     * Event handlers (pointerdown, click, dblclick, contextmenu) are still bound inline in templates.
      */
     getCellInteractionProps(descriptor: {
         isActive: boolean;
@@ -271,14 +272,14 @@ export declare abstract class BaseDataGridTableComponent<T = unknown> {
     setPendingEditorValue(value: unknown): void;
     cancelPopoverEdit(): void;
     commitPopoverEdit(item: T, columnId: string, oldValue: unknown, newValue: unknown, rowIndex: number, globalColIndex: number): void;
-    onWrapperMouseDown(event: MouseEvent): void;
+    onWrapperMouseDown(event: PointerEvent): void;
     onGridKeyDown(event: KeyboardEvent): void;
-    onCellMouseDown(event: MouseEvent, rowIndex: number, globalColIndex: number): void;
+    onCellMouseDown(event: PointerEvent, rowIndex: number, globalColIndex: number): void;
     onCellClick(rowIndex: number, globalColIndex: number): void;
     onCellContextMenu(event: MouseEvent): void;
     onCellDblClick(rowId: RowId, columnId: string): void;
-    onFillHandleMouseDown(event: MouseEvent): void;
-    onResizeStart(event: MouseEvent, col: IColumnDef<T>): void;
+    onFillHandleMouseDown(event: PointerEvent): void;
+    onResizeStart(event: PointerEvent, col: IColumnDef<T>): void;
     onResizeDoubleClick(event: MouseEvent, col: IColumnDef<T>): void;
     onSelectAllChange(event: Event): void;
     onRowClick(event: MouseEvent, rowId: RowId): void;
@@ -293,7 +294,7 @@ export declare abstract class BaseDataGridTableComponent<T = unknown> {
     handleSelectAllCells(): void;
     onUndo(): void;
     onRedo(): void;
-    onHeaderMouseDown(columnId: string, event: MouseEvent): void;
+    onHeaderMouseDown(columnId: string, event: PointerEvent): void;
     onPinColumn(columnId: string, side: 'left' | 'right'): void;
     onUnpinColumn(columnId: string): void;
     isPinned(columnId: string): 'left' | 'right' | undefined;

package/dist/types/components/formula-ref-overlay.component.d.ts

@@ -4,7 +4,7 @@
  *
  * Port of React's FormulaRefOverlay component.
  */
-import { type FormulaReference } from '@alaarab/ogrid-core';
+import { type FormulaReference } from '@alaarab/ogrid-core/formula';
 interface RefRect {
     top: number;
     left: number;

package/dist/types/index.d.ts

@@ -1,5 +1,7 @@
-export * from '@alaarab/ogrid-core';
-export { CHECKBOX_COLUMN_WIDTH, ROW_NUMBER_COLUMN_WIDTH, ROW_NUMBER_COLUMN_ID, ROW_NUMBER_COLUMN_MIN_WIDTH, DEFAULT_MIN_COLUMN_WIDTH, CELL_PADDING, GRID_BORDER_RADIUS, PEOPLE_SEARCH_DEBOUNCE_MS, DEFAULT_DEBOUNCE_MS, SIDEBAR_TRANSITION_MS, Z_INDEX, } from '@alaarab/ogrid-core';
+export type { ISheetDef, IVirtualScrollConfig, IColumnReorderConfig, CsvColumn, FormulaExportOptions, StatusBarPart, StatusBarPartsInput, PaginationViewModel, GridContextMenuItem, IColumnHeaderMenuItem, GridContextMenuHandlerProps, ColumnHeaderMenuInput, ColumnHeaderMenuHandlers, ParseValueResult, AggregationResult, GridRowComparatorProps, ColumnPinState, IDropTarget, ICalculateDropTargetParams, IVisibleRange, IVisibleColumnRange, SortFilterRequest, SortFilterResponse, OverlayRect, ISortState, ArrowNavigationContext, ArrowNavigationResult, IFillFormulaOptions, FormulaReference, IResponsiveColumnsConfig, ZIndexKey, ICellAddress, ICellRange, CellKey, FormulaErrorType, TokenType, Token, ASTNode, BinaryOp, IFormulaContext, IFormulaFunction, IEvaluator, IRecalcResult, IFormulaEngineConfig, IGridDataAccessor, INamedRange, IAuditEntry, IAuditTrail, } from '@alaarab/ogrid-core';
+export { escapeCsvValue, buildCsvHeader, buildCsvRows, exportToCsv, triggerCsvDownload, getCellValue, isColumnEditable, createGridDataAccessor, flattenColumns, buildHeaderRows, isFilterConfig, getFilterField, mergeFilter, deriveFilterOptionsFromData, getMultiSelectFilterFields, getStatusBarParts, getDataGridStatusBarConfig, getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, GRID_CONTEXT_MENU_ITEMS, COLUMN_HEADER_MENU_ITEMS, getContextMenuHandlers, getColumnHeaderMenuItems, formatShortcut, parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, computeAggregations, processClientSideData, areGridRowPropsEqual, isRowInRange, getPinStateForColumn, reorderColumnArray, calculateDropTarget, computeVisibleRange, computeTotalHeight, getScrollTopForRow, computeVisibleColumnRange, partitionColumnsForVirtualization, createSortFilterWorker, terminateSortFilterWorker, extractValueMatrix, processClientSideDataAsync, CellDescriptorCache, buildInlineEditorProps, buildPopoverEditorProps, measureRange, buildCellIndex, injectGlobalStyles, computeNextSortState, measureColumnContentWidth, AUTOSIZE_EXTRA_PX, AUTOSIZE_MAX_PX, findCtrlArrowTarget, computeTabNavigation, computeArrowNavigation, applyCellDeletion, rangesEqual, clampSelectionToBounds, computeAutoScrollSpeed, applyRangeRowSelection, computeRowSelectionState, formatCellValueForTsv, formatSelectionAsTsv, parseTsvClipboard, applyPastedValues, applyCutClear, applyFillValues, UndoRedoStack, validateColumns, validateRowIds, validateVirtualScrollConfig, indexToColumnLetter, columnLetterToIndex, formatCellReference, getResponsiveHiddenColumns, RESPONSIVE_BREAKPOINTS, resolveResponsiveConfig, applyResponsiveHiding, } from '@alaarab/ogrid-core';
+export { CHECKBOX_COLUMN_WIDTH, ROW_NUMBER_COLUMN_WIDTH, ROW_NUMBER_COLUMN_ID, ROW_NUMBER_COLUMN_MIN_WIDTH, DEFAULT_MIN_COLUMN_WIDTH, CELL_PADDING, GRID_BORDER_RADIUS, DEFAULT_DEBOUNCE_MS, PEOPLE_SEARCH_DEBOUNCE_MS, SIDEBAR_TRANSITION_MS, Z_INDEX, } from '@alaarab/ogrid-core';
+export { FormulaError, FormulaEngine, FormulaEvaluator, DependencyGraph, tokenize, parse, createBuiltInFunctions, parseCellRef, parseRange, formatAddress, toCellKey, fromCellKey, adjustFormulaReferences, toNumber, formulaToString, toBoolean, flattenArgs, isFormulaError, REF_ERROR, DIV_ZERO_ERROR, VALUE_ERROR, NAME_ERROR, CIRC_ERROR, GENERAL_ERROR, NA_ERROR, extractFormulaReferences, processFormulaBarCommit, deriveFormulaBarText, handleFormulaBarKeyDown, canInsertReference, insertReferenceAtCursor, FORMULA_REF_COLORS, FORMULA_BAR_CSS, FORMULA_BAR_STYLES, } from '@alaarab/ogrid-core/formula';
 export type { IColumnDef, IColumnGroupDef, IColumnDefinition, ICellEditorProps, } from './types';
 export type { IOGridProps, IOGridClientProps, IOGridServerProps, IOGridDataGridProps, } from './types';
 export type { ColumnFilterType, IColumnFilterDef, IColumnMeta, ICellValueChangedEvent, CellEditorParams, IValueParserParams, IDateFilterValue, HeaderCell, HeaderRow, RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, IOGridApi, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, SideBarPanelId, ISideBarDef, } from './types';

package/dist/types/services/column-reorder.service.d.ts

@@ -21,7 +21,7 @@ export declare class ColumnReorderService<T> {
      * @param columnId - The column being dragged
      * @param event - The native MouseEvent
      */
-    handleHeaderMouseDown(columnId: string, event: MouseEvent): void;
+    handleHeaderMouseDown(columnId: string, event: PointerEvent): void;
     /**
      * Calculate drop target from mouse position and header cell rects.
      * Same logic as React's useColumnReorder inline calculation.

package/dist/types/services/datagrid-interaction.service.d.ts

@@ -30,7 +30,7 @@ export declare class DataGridInteractionHelper<T> {
         startCol: number;
     } | null;
     fillRafId: number;
-    fillMoveHandler: ((e: MouseEvent) => void) | null;
+    fillMoveHandler: ((e: PointerEvent) => void) | null;
     fillUpHandler: (() => void) | null;
     dragStartPos: {
         row: number;
@@ -65,9 +65,9 @@ export declare class DataGridInteractionHelper<T> {
     endBatch(): void;
     undo(originalOnCellValueChanged: ((event: ICellValueChangedEvent<T>) => void) | undefined): void;
     redo(originalOnCellValueChanged: ((event: ICellValueChangedEvent<T>) => void) | undefined): void;
-    handleCellMouseDown(e: MouseEvent, rowIndex: number, globalColIndex: number, colOffset: number, wrapperEl: HTMLElement | null): void;
+    handleCellMouseDown(e: PointerEvent, rowIndex: number, globalColIndex: number, colOffset: number, wrapperEl: HTMLElement | null): void;
     handleSelectAllCells(rowCount: number, visibleColCount: number, colOffset: number): void;
-    handleFillHandleMouseDown(e: MouseEvent): void;
+    handleFillHandleMouseDown(e: PointerEvent): void;
     handleGridKeyDown(e: KeyboardEvent, items: T[], getRowId: (item: T) => RowId, visibleCols: IColumnDef<T>[], colOffset: number, hasCheckboxCol: boolean, visibleColumnCount: number, editable: boolean | undefined, wrappedOnCellValueChanged: ((event: ICellValueChangedEvent<T>) => void) | undefined, originalOnCellValueChanged: ((event: ICellValueChangedEvent<T>) => void) | undefined, rowSelection: string, selectedRowIds: Set<RowId>, wrapperEl: HTMLElement | null, handleRowCheckboxChange: (rowId: RowId, checked: boolean, rowIndex: number, shiftKey: boolean) => void, editingCell: {
         rowId: RowId;
         columnId: string;
@@ -75,7 +75,7 @@ export declare class DataGridInteractionHelper<T> {
         rowId: RowId;
         columnId: string;
     } | null) => void, onKeyDown?: (event: KeyboardEvent) => void): void;
-    onWindowMouseMove(e: MouseEvent, colOffset: number, wrapperEl: HTMLElement | null): void;
+    onWindowMouseMove(e: PointerEvent, colOffset: number, wrapperEl: HTMLElement | null): void;
     onWindowMouseUp(colOffset: number, wrapperEl: HTMLElement | null): void;
     resolveRangeFromMouse(cx: number, cy: number, colOffset: number): ISelectionRange | null;
     applyDragAttrs(range: ISelectionRange, colOff: number, wrapper: HTMLElement | null): void;

package/dist/types/services/datagrid-state.service.d.ts

@@ -58,12 +58,12 @@ export interface DataGridCellInteractionState {
     selectionRange: ISelectionRange | null;
     /** Set selection range. Undefined when cell selection is disabled. */
     setSelectionRange?: (range: ISelectionRange | null) => void;
-    handleCellMouseDown: (e: MouseEvent, rowIndex: number, globalColIndex: number) => void;
+    handleCellMouseDown: (e: PointerEvent, rowIndex: number, globalColIndex: number) => void;
     handleSelectAllCells: () => void;
     hasCellSelection: boolean;
     handleGridKeyDown: (e: KeyboardEvent) => void;
     /** Handle fill handle mouse down. Undefined when cell selection is disabled. */
-    handleFillHandleMouseDown?: (e: MouseEvent) => void;
+    handleFillHandleMouseDown?: (e: PointerEvent) => void;
     handleCopy: () => void;
     handleCut: () => void;
     handlePaste: () => Promise<void>;
@@ -121,6 +121,7 @@ export interface DataGridViewModelState<T> {
         isDragging: boolean;
         getFormulaValue?: (col: number, row: number) => unknown;
         hasFormula?: (col: number, row: number) => boolean;
+        getFormula?: (col: number, row: number) => string | undefined;
         formulaVersion?: number;
     };
     statusBarConfig: IStatusBarProps | null;
@@ -223,7 +224,7 @@ export declare class DataGridStateService<T> {
     setSelectionRange(range: ISelectionRange | null): void;
     commitCellEdit(item: T, columnId: string, oldValue: unknown, newValue: unknown, rowIndex: number, globalColIndex: number): void;
     cancelPopoverEdit(): void;
-    handleCellMouseDown(e: MouseEvent, rowIndex: number, globalColIndex: number): void;
+    handleCellMouseDown(e: PointerEvent, rowIndex: number, globalColIndex: number): void;
     handleSelectAllCells(): void;
     setContextMenuPosition(pos: {
         x: number;
@@ -244,7 +245,7 @@ export declare class DataGridStateService<T> {
     undo(): void;
     redo(): void;
     handleGridKeyDown(e: KeyboardEvent): void;
-    handleFillHandleMouseDown(e: MouseEvent): void;
+    handleFillHandleMouseDown(e: PointerEvent): void;
     pinColumn(columnId: string, side: 'left' | 'right'): void;
     unpinColumn(columnId: string): void;
     isPinned(columnId: string): 'left' | 'right' | undefined;

package/dist/types/services/ogrid.service.d.ts

@@ -1,5 +1,5 @@
 import type { FormulaReference } from '@alaarab/ogrid-core';
-import type { RowId, IOGridApi, IFilters, FilterValue, IRowSelectionChangeEvent, IStatusBarProps, IColumnDefinition, IDataSource, ISideBarDef, IVirtualScrollConfig, SideBarPanelId, IFormulaFunction, IRecalcResult, IGridDataAccessor } from '../types';
+import type { RowId, IOGridApi, IFilters, FilterValue, IRowSelectionChangeEvent, IStatusBarProps, IColumnDefinition, IDataSource, ISideBarDef, IVirtualScrollConfig, IResponsiveColumnsConfig, SideBarPanelId, IFormulaFunction, IRecalcResult, IGridDataAccessor } from '../types';
 import type { IOGridProps, IOGridDataGridProps } from '../types';
 import type { IColumnDef, IColumnGroupDef, ICellValueChangedEvent } from '../types';
 import type { SideBarProps } from '../components/sidebar.component';
@@ -117,6 +117,7 @@ export declare class OGridService<T> {
     readonly onError: import("@angular/core").WritableSignal<((error: unknown) => void) | undefined>;
     readonly columnChooserProp: import("@angular/core").WritableSignal<boolean | "toolbar" | "sidebar" | undefined>;
     readonly columnReorder: import("@angular/core").WritableSignal<boolean | undefined>;
+    readonly responsiveColumns: import("@angular/core").WritableSignal<boolean | IResponsiveColumnsConfig | undefined>;
     readonly virtualScroll: import("@angular/core").WritableSignal<IVirtualScrollConfig | undefined>;
     readonly ariaLabel: import("@angular/core").WritableSignal<string | undefined>;
     readonly ariaLabelledBy: import("@angular/core").WritableSignal<string | undefined>;

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

@@ -1,6 +1,7 @@
 import type { TemplateRef } from '@angular/core';
 import type { IColumnDef, IColumnGroupDef, ICellValueChangedEvent } from './columnTypes';
-export type { RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, SideBarPanelId, ISideBarDef, IVirtualScrollConfig, IOGridApi, IFormulaFunction, IRecalcResult, IGridDataAccessor, IAuditEntry, IAuditTrail, ISheetDef, FormulaReference, } from '@alaarab/ogrid-core';
+import type { IResponsiveColumnsConfig } from '@alaarab/ogrid-core';
+export type { RowId, UserLike, UserLikeInput, FilterValue, IFilters, IFetchParams, IPageResult, IDataSource, IGridColumnState, RowSelectionMode, IRowSelectionChangeEvent, StatusBarPanel, IStatusBarProps, IActiveCell, ISelectionRange, SideBarPanelId, ISideBarDef, IVirtualScrollConfig, IResponsiveColumnsConfig, IOGridApi, IFormulaFunction, IRecalcResult, IGridDataAccessor, IAuditEntry, IAuditTrail, ISheetDef, FormulaReference, } from '@alaarab/ogrid-core';
 export { toUserLike, isInSelectionRange, normalizeSelectionRange } from '@alaarab/ogrid-core';
 import type { RowId, UserLike, IFilters, FilterValue, RowSelectionMode, IRowSelectionChangeEvent, IStatusBarProps, IDataSource, ISideBarDef, IVirtualScrollConfig, IFormulaFunction, IRecalcResult, IGridDataAccessor, IAuditEntry, IAuditTrail, ISheetDef, FormulaReference } from '@alaarab/ogrid-core';
 /** Base props shared by both client-side and server-side OGrid modes. */
@@ -62,6 +63,8 @@ interface IOGridBaseProps<T> {
     fullScreen?: boolean;
     sideBar?: boolean | ISideBarDef;
     columnReorder?: boolean;
+    /** Enable responsive column hiding based on container width. Columns with `responsivePriority` are auto-hidden on narrow containers. */
+    responsiveColumns?: boolean | IResponsiveColumnsConfig;
     virtualScroll?: IVirtualScrollConfig;
     /** Offload sort/filter to a Web Worker for large datasets. Falls back to sync when sort column has a custom compare. */
     workerSort?: boolean;
@@ -162,6 +165,8 @@ export interface IOGridDataGridProps<T> {
     peopleSearch?: (query: string) => Promise<UserLike[]>;
     getUserByEmail?: (email: string) => Promise<UserLike | undefined>;
     columnReorder?: boolean;
+    /** Responsive column hiding config. */
+    responsiveColumns?: boolean | IResponsiveColumnsConfig;
     virtualScroll?: IVirtualScrollConfig;
     /** Fixed row height in pixels. Overrides default row height (36px). */
     rowHeight?: number;

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, IVirtualScrollConfig, IFormulaFunction, IRecalcResult, IGridDataAccessor, IAuditEntry, IAuditTrail, ISheetDef, FormulaReference, } 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, IVirtualScrollConfig, IResponsiveColumnsConfig, IFormulaFunction, IRecalcResult, IGridDataAccessor, IAuditEntry, IAuditTrail, ISheetDef, FormulaReference, } from './dataGridTypes';
 export { toUserLike, isInSelectionRange, normalizeSelectionRange } from './dataGridTypes';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-angular",
-  "version": "2.4.2",
+  "version": "2.5.1",
   "description": "OGrid Angular – Angular services, signals, and headless components for OGrid data grids.",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",
@@ -35,7 +35,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@alaarab/ogrid-core": "2.4.2"
+    "@alaarab/ogrid-core": "2.5.1"
   },
   "peerDependencies": {
     "@angular/core": "^21.0.0",