@alaarab/ogrid-angular-material 2.2.0 → 2.4.0

package/dist/esm/index.js

@@ -1,6 +1,6 @@
-import { INLINE_CELL_EDITOR_STYLES, INLINE_CELL_EDITOR_TEMPLATE, POPOVER_CELL_EDITOR_OVERLAY_STYLES, POPOVER_CELL_EDITOR_TEMPLATE, OGRID_THEME_VARS_CSS, CHECKBOX_COLUMN_WIDTH, ROW_NUMBER_COLUMN_WIDTH, DataGridStateService, ColumnReorderService, VirtualScrollService, StatusBarComponent, GridContextMenuComponent, MarchingAntsOverlayComponent, EmptyStateComponent, OGridService, OGridLayoutComponent, BaseColumnHeaderFilterComponent, getColumnHeaderMenuItems, BaseInlineCellEditorComponent, BasePopoverCellEditorComponent, BaseDataGridTableComponent, BaseColumnChooserComponent, BasePaginationControlsComponent, BaseOGridComponent } from '@alaarab/ogrid-angular';
+import { INLINE_CELL_EDITOR_STYLES, INLINE_CELL_EDITOR_TEMPLATE, POPOVER_CELL_EDITOR_OVERLAY_STYLES, POPOVER_CELL_EDITOR_TEMPLATE, OGRID_THEME_VARS_CSS, CHECKBOX_COLUMN_WIDTH, ROW_NUMBER_COLUMN_WIDTH, DataGridStateService, ColumnReorderService, VirtualScrollService, StatusBarComponent, GridContextMenuComponent, MarchingAntsOverlayComponent, EmptyStateComponent, FormulaRefOverlayComponent, OGridService, OGridLayoutComponent, BaseColumnHeaderFilterComponent, BaseColumnHeaderMenuComponent, BaseInlineCellEditorComponent, BasePopoverCellEditorComponent, BaseDataGridTableComponent, formatCellReference, indexToColumnLetter, BaseColumnChooserComponent, BasePaginationControlsComponent, BaseOGridComponent } from '@alaarab/ogrid-angular';
 export { AUTOSIZE_EXTRA_PX, AUTOSIZE_MAX_PX, BaseColumnChooserComponent, BaseColumnHeaderFilterComponent, BaseDataGridTableComponent, BaseInlineCellEditorComponent, BaseOGridComponent, BasePaginationControlsComponent, BasePopoverCellEditorComponent, CELL_PADDING, CHECKBOX_COLUMN_WIDTH, COLUMN_HEADER_MENU_ITEMS, ColumnReorderService, DEFAULT_DEBOUNCE_MS, DEFAULT_MIN_COLUMN_WIDTH, DataGridEditingHelper, DataGridInteractionHelper, DataGridLayoutHelper, DataGridStateService, EmptyStateComponent, GRID_BORDER_RADIUS, GRID_CONTEXT_MENU_ITEMS, GridContextMenuComponent, INLINE_CELL_EDITOR_STYLES, INLINE_CELL_EDITOR_TEMPLATE, MAX_PAGE_BUTTONS, MarchingAntsOverlayComponent, OGRID_THEME_VARS_CSS, OGridLayoutComponent, OGridService, PAGE_SIZE_OPTIONS, PEOPLE_SEARCH_DEBOUNCE_MS, POPOVER_CELL_EDITOR_OVERLAY_STYLES, POPOVER_CELL_EDITOR_TEMPLATE, ROW_NUMBER_COLUMN_WIDTH, SIDEBAR_TRANSITION_MS, SideBarComponent, StatusBarComponent, UndoRedoStack, VirtualScrollService, Z_INDEX, applyCellDeletion, applyCutClear, applyFillValues, applyPastedValues, applyRangeRowSelection, areGridRowPropsEqual, booleanParser, buildCsvHeader, buildCsvRows, buildHeaderRows, buildInlineEditorProps, buildPopoverEditorProps, calculateDropTarget, clampSelectionToBounds, computeAggregations, computeArrowNavigation, computeAutoScrollSpeed, computeNextSortState, computeRowSelectionState, computeTabNavigation, computeTotalHeight, computeVisibleRange, createDebouncedCallback, createDebouncedSignal, createLatestCallback, currencyParser, dateParser, debounce, deriveFilterOptionsFromData, emailParser, escapeCsvValue, exportToCsv, findCtrlArrowTarget, flattenColumns, formatCellValueForTsv, formatSelectionAsTsv, formatShortcut, getCellRenderDescriptor, getCellValue, getColumnHeaderMenuItems, getContextMenuHandlers, getDataGridStatusBarConfig, getFilterField, getHeaderFilterConfig, getMultiSelectFilterFields, getPaginationViewModel, getPinStateForColumn, getScrollTopForRow, getStatusBarParts, injectGlobalStyles, isFilterConfig, isInSelectionRange, isRowInRange, measureColumnContentWidth, measureRange, mergeFilter, normalizeSelectionRange, numberParser, parseTsvClipboard, parseValue, processClientSideData, rangesEqual, reorderColumnArray, resolveCellDisplayContent, resolveCellStyle, toUserLike, triggerCsvDownload, validateColumns, validateRowIds } from '@alaarab/ogrid-angular';
-import { ViewChild, Component, ChangeDetectionStrategy, Input, ViewEncapsulation, signal, computed } from '@angular/core';
+import { ViewChild, Component, ChangeDetectionStrategy, Input, ViewEncapsulation, signal, computed, effect } from '@angular/core';
 import { MatMenuTrigger, MatMenuModule } from '@angular/material/menu';
 import { MatDividerModule } from '@angular/material/divider';
 
@@ -329,88 +329,8 @@ ColumnHeaderFilterComponent = __decorateClass([
     }
   })
 ], ColumnHeaderFilterComponent);
-var ColumnHeaderMenuComponent = class {
-  constructor() {
-    // Signal-backed inputs so computed() tracks changes reactively
-    this._canPinLeft = signal(true);
-    this._canPinRight = signal(true);
-    this._canUnpin = signal(false);
-    this._currentSort = signal(null);
-    this._isSortable = signal(true);
-    this._isResizable = signal(true);
-    this.handlers = {};
-    this.menuItems = computed(
-      () => getColumnHeaderMenuItems({
-        canPinLeft: this._canPinLeft(),
-        canPinRight: this._canPinRight(),
-        canUnpin: this._canUnpin(),
-        currentSort: this._currentSort(),
-        isSortable: this._isSortable(),
-        isResizable: this._isResizable()
-      })
-    );
-  }
-  set canPinLeft(v) {
-    this._canPinLeft.set(v);
-  }
-  set canPinRight(v) {
-    this._canPinRight.set(v);
-  }
-  set canUnpin(v) {
-    this._canUnpin.set(v);
-  }
-  set currentSort(v) {
-    this._currentSort.set(v);
-  }
-  set isSortable(v) {
-    this._isSortable.set(v);
-  }
-  set isResizable(v) {
-    this._isResizable.set(v);
-  }
-  handleMenuItemClick(itemId) {
-    const h = this.handlers;
-    const actionMap = {
-      pinLeft: h.onPinLeft,
-      pinRight: h.onPinRight,
-      unpin: h.onUnpin,
-      sortAsc: h.onSortAsc,
-      sortDesc: h.onSortDesc,
-      clearSort: h.onClearSort,
-      autosizeThis: h.onAutosizeThis,
-      autosizeAll: h.onAutosizeAll
-    };
-    const action = actionMap[itemId];
-    if (action) {
-      action();
-      h.onClose?.();
-    }
-  }
+var ColumnHeaderMenuComponent = class extends BaseColumnHeaderMenuComponent {
 };
-__decorateClass([
-  Input({ required: true })
-], ColumnHeaderMenuComponent.prototype, "columnId", 2);
-__decorateClass([
-  Input()
-], ColumnHeaderMenuComponent.prototype, "canPinLeft", 1);
-__decorateClass([
-  Input()
-], ColumnHeaderMenuComponent.prototype, "canPinRight", 1);
-__decorateClass([
-  Input()
-], ColumnHeaderMenuComponent.prototype, "canUnpin", 1);
-__decorateClass([
-  Input()
-], ColumnHeaderMenuComponent.prototype, "currentSort", 1);
-__decorateClass([
-  Input()
-], ColumnHeaderMenuComponent.prototype, "isSortable", 1);
-__decorateClass([
-  Input()
-], ColumnHeaderMenuComponent.prototype, "isResizable", 1);
-__decorateClass([
-  Input()
-], ColumnHeaderMenuComponent.prototype, "handlers", 2);
 __decorateClass([
   ViewChild(MatMenuTrigger)
 ], ColumnHeaderMenuComponent.prototype, "menuTrigger", 2);
@@ -506,7 +426,22 @@ var DataGridTableComponent = class extends BaseDataGridTableComponent {
   constructor() {
     super();
     this.propsSignal = signal(void 0);
+    this.showColumnLetters = computed(() => !!this.getProps()?.showColumnLetters);
+    this.formulaReferences = computed(() => this.getProps()?.formulaReferences);
     this.initBase();
+    effect(() => {
+      const props = this.getProps();
+      const onActiveCellChange = props?.onActiveCellChange;
+      if (!onActiveCellChange) return;
+      const ac = this.activeCell();
+      if (ac) {
+        const colIndex = ac.columnIndex - this.colOffset();
+        const rowNumber = ac.rowIndex + 1;
+        onActiveCellChange(formatCellReference(colIndex, rowNumber));
+      } else {
+        onActiveCellChange(null);
+      }
+    });
   }
   set propsInput(value) {
     this.propsSignal.set(value);
@@ -520,6 +455,9 @@ var DataGridTableComponent = class extends BaseDataGridTableComponent {
   getTableContainerRef() {
     return this.tableContainerRef;
   }
+  getColumnLetter(colIdx) {
+    return indexToColumnLetter(colIdx);
+  }
 };
 __decorateClass([
   Input({ required: true, alias: "props" })
@@ -536,7 +474,7 @@ DataGridTableComponent = __decorateClass([
     standalone: true,
     changeDetection: ChangeDetectionStrategy.OnPush,
     encapsulation: ViewEncapsulation.None,
-    imports: [ColumnHeaderFilterComponent, ColumnHeaderMenuComponent, StatusBarComponent, GridContextMenuComponent, MarchingAntsOverlayComponent, EmptyStateComponent, InlineCellEditorComponent, PopoverCellEditorComponent],
+    imports: [ColumnHeaderFilterComponent, ColumnHeaderMenuComponent, StatusBarComponent, GridContextMenuComponent, MarchingAntsOverlayComponent, EmptyStateComponent, FormulaRefOverlayComponent, InlineCellEditorComponent, PopoverCellEditorComponent],
     providers: [DataGridStateService, ColumnReorderService, VirtualScrollService],
     template: `
     <div class="ogrid-datagrid-root">
@@ -564,6 +502,21 @@ DataGridTableComponent = __decorateClass([
                 [attr.data-virtual-scroll]="vsEnabled() ? '' : null"
               >
                 <thead [class]="stickyHeader() ? 'ogrid-datagrid-thead ogrid-sticky-header' : 'ogrid-datagrid-thead'">
+                  @if (showColumnLetters()) {
+                    <tr class="ogrid-column-letter-row">
+                      @if (hasCheckboxCol()) {
+                        <th class="ogrid-column-letter-cell"></th>
+                      }
+                      @if (hasRowNumbersCol()) {
+                        <th class="ogrid-column-letter-cell"></th>
+                      }
+                      @for (col of visibleCols(); track col.columnId; let colIdx = $index) {
+                        <th class="ogrid-column-letter-cell">
+                          {{ getColumnLetter(colIdx) }}
+                        </th>
+                      }
+                    </tr>
+                  }
                   @for (row of headerRows(); track $index; let rowIdx = $index) {
                     <tr class="ogrid-datagrid-header-row">
                       @if (rowIdx === headerRows().length - 1 && hasCheckboxCol()) {
@@ -739,10 +692,11 @@ DataGridTableComponent = __decorateClass([
                               ></ogrid-mat-popover-cell-editor>
                             } @else {
                               @let content = resolveCellContent(colLayout.col, item, descriptor.displayValue);
-                              @let cellStyle = resolveCellStyleFn(colLayout.col, item);
+                              @let cellStyle = resolveCellStyleFn(colLayout.col, item, descriptor.displayValue);
                               <div
                                 class="ogrid-datagrid-cell"
                                 [class.ogrid-datagrid-cell--active]="descriptor.isActive"
+                                [class.ogrid-datagrid-cell--active-in-range]="descriptor.isActive && descriptor.isInRange"
                                 [class.ogrid-datagrid-cell--in-range]="descriptor.isInRange && !descriptor.isActive"
                                 [class.ogrid-datagrid-cell--in-cut-range]="descriptor.isInCutRange"
                                 [class.ogrid-datagrid-cell--editable]="descriptor.canEditAny"
@@ -795,6 +749,14 @@ DataGridTableComponent = __decorateClass([
                 [columnOrder]="propsColumnOrder()"
               ></ogrid-marching-ants-overlay>
 
+              @if (formulaReferences() && formulaReferences()!.length > 0) {
+                <ogrid-formula-ref-overlay
+                  [containerEl]="tableContainerEl()"
+                  [references]="formulaReferences()!"
+                  [colOffset]="colOffset()"
+                />
+              }
+
               @if (showEmptyInGrid() && emptyState()) {
                 <div class="ogrid-datagrid-empty">
                   <div class="ogrid-datagrid-empty__title">No results found</div>
@@ -955,6 +917,7 @@ DataGridTableComponent = __decorateClass([
       outline: 2px solid var(--ogrid-selection-color, #217346); outline-offset: -1px;
       z-index: 2; position: relative; overflow: visible;
     }
+    .ogrid-datagrid-cell--active-in-range { outline: none; background: var(--ogrid-bg, #fff); }
     .ogrid-datagrid-cell--in-range { background: var(--ogrid-range-bg, rgba(33, 115, 70, 0.12)); }
     .ogrid-datagrid-cell--in-cut-range { background: var(--ogrid-hover-bg, rgba(0, 0, 0, 0.04)); opacity: 0.7; }
     .ogrid-datagrid-cell--editing { padding: 0; }
@@ -1026,6 +989,17 @@ DataGridTableComponent = __decorateClass([
     .ogrid-datagrid-context-menu-overlay {
       position: fixed; inset: 0; z-index: 1000;
     }
+    .ogrid-column-letter-cell {
+      text-align: center;
+      font-size: 11px;
+      font-weight: 500;
+      color: var(--ogrid-fg-muted, rgba(0, 0, 0, 0.4));
+      padding: 2px 4px;
+      background: var(--ogrid-column-letter-bg, var(--ogrid-header-bg, rgba(0, 0, 0, 0.04)));
+      border-bottom: 1px solid var(--ogrid-border, rgba(0, 0, 0, 0.12));
+      user-select: none;
+      font-variant-numeric: tabular-nums;
+    }
 
     /* Angular Material Menu popup dark mode overrides.
        Double-class selector (0,2,0) beats MUI's single-class (0,1,0) defaults. */
@@ -1292,6 +1266,13 @@ OGridComponent = __decorateClass([
       [hasToolbarBelow]="false"
       [hasPagination]="true"
       [fullScreen]="ogridService.fullScreen()"
+      [showNameBox]="!!(ogridService.cellReferences() && !ogridService.formulasEnabled())"
+      [activeCellRef]="ogridService.activeCellRef()"
+      [formulaBar]="ogridService.formulasEnabled() ? ogridService.formulaBarState() : null"
+      [sheetDefs]="ogridService.sheetDefs()"
+      [activeSheet]="ogridService.activeSheet()"
+      [onSheetChange]="ogridService.onSheetChange()"
+      [onSheetAdd]="ogridService.onSheetAdd()"
     >
       <ng-container toolbarEnd>
         @if (ogridService.columnChooserPlacement() === 'toolbar') {

package/dist/types/column-header-menu/column-header-menu.component.d.ts

@@ -1,28 +1,5 @@
 import { MatMenuTrigger } from '@angular/material/menu';
-import { type IColumnHeaderMenuItem, type ColumnHeaderMenuHandlers } from '@alaarab/ogrid-angular';
-/**
- * Column header dropdown menu for pin/unpin, sort, and autosize actions.
- * Uses Angular Material MatMenu.
- *
- * Uses signal-backed @Input setters so that computed() tracks changes
- * (plain @Input properties are not reactive in Angular signals).
- */
-export declare class ColumnHeaderMenuComponent {
-    columnId: string;
-    private readonly _canPinLeft;
-    private readonly _canPinRight;
-    private readonly _canUnpin;
-    private readonly _currentSort;
-    private readonly _isSortable;
-    private readonly _isResizable;
-    set canPinLeft(v: boolean);
-    set canPinRight(v: boolean);
-    set canUnpin(v: boolean);
-    set currentSort(v: 'asc' | 'desc' | null);
-    set isSortable(v: boolean);
-    set isResizable(v: boolean);
-    handlers: Partial<ColumnHeaderMenuHandlers>;
+import { BaseColumnHeaderMenuComponent } from '@alaarab/ogrid-angular';
+export declare class ColumnHeaderMenuComponent extends BaseColumnHeaderMenuComponent {
     menuTrigger?: MatMenuTrigger;
-    readonly menuItems: import("@angular/core").Signal<IColumnHeaderMenuItem[]>;
-    handleMenuItemClick(itemId: string): void;
 }

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

@@ -10,8 +10,11 @@ export declare class DataGridTableComponent<T> extends BaseDataGridTableComponen
     set propsInput(value: IOGridDataGridProps<T>);
     private wrapperRef?;
     private tableContainerRef?;
+    readonly showColumnLetters: import("@angular/core").Signal<boolean>;
+    readonly formulaReferences: import("@angular/core").Signal<import("@alaarab/ogrid-core").FormulaReference[] | undefined>;
     constructor();
     protected getProps(): IOGridDataGridProps<T> | undefined;
     protected getWrapperRef(): ElementRef<HTMLElement> | undefined;
     protected getTableContainerRef(): ElementRef<HTMLElement> | undefined;
+    getColumnLetter(colIdx: number): string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alaarab/ogrid-angular-material",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "OGrid Angular Material – MatTable-based data grid with sorting, filtering, pagination, column chooser, and CSV export.",
   "main": "dist/esm/index.js",
   "module": "dist/esm/index.js",
@@ -37,7 +37,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@alaarab/ogrid-angular": "2.2.0"
+    "@alaarab/ogrid-angular": "2.4.0"
   },
   "peerDependencies": {
     "@angular/cdk": "^21.0.0",