@alaarab/ogrid-core 2.2.0 → 2.3.0

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

@@ -4,15 +4,32 @@
  */
 import type { IColumnDef, ICellValueChangedEvent } from '../types/columnTypes';
 import type { ISelectionRange } from '../types/dataGridTypes';
+/**
+ * Options for formula-aware fill. When provided, source cells with formulas will
+ * have their relative references adjusted instead of copying raw values.
+ */
+export interface IFillFormulaOptions<T> {
+    /** Flat (unfiltered) column list used to map visible col indices to formula storage indices. */
+    flatColumns: IColumnDef<T>[];
+    /** Returns the formula string for a given (flatColIndex, rowIndex), or undefined if none. */
+    getFormula?: (col: number, row: number) => string | undefined;
+    /** Returns true if the cell at (flatColIndex, rowIndex) has a formula. */
+    hasFormula?: (col: number, row: number) => boolean;
+    /** Sets or clears the formula at (flatColIndex, rowIndex). Pass null to clear. */
+    setFormula?: (col: number, row: number, formula: string | null) => void;
+}
 /**
  * Apply fill values from a source cell across a normalized selection range.
  * Copies the value from the start cell of the range to every other editable cell.
+ * If formulaOptions is provided and the source cell has a formula, relative references
+ * in the formula are adjusted for each target cell instead of copying the raw value.
  *
  * @param range           The normalized fill range (startRow/startCol is the source).
  * @param sourceRow       The original source row index (skipped during fill).
  * @param sourceCol       The original source col index (skipped during fill).
  * @param items           Array of all row data objects.
  * @param visibleCols     Visible column definitions.
+ * @param formulaOptions  Optional formula-aware fill configuration.
  * @returns Array of cell value changed events to apply. Empty if source cell is out of bounds.
  */
-export declare function applyFillValues<T>(range: ISelectionRange, sourceRow: number, sourceCol: number, items: T[], visibleCols: IColumnDef<T>[]): ICellValueChangedEvent<T>[];
+export declare function applyFillValues<T>(range: ISelectionRange, sourceRow: number, sourceCol: number, items: T[], visibleCols: IColumnDef<T>[], formulaOptions?: IFillFormulaOptions<T>): ICellValueChangedEvent<T>[];

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

@@ -7,7 +7,7 @@ export { getDataGridStatusBarConfig } from './dataGridStatusBar';
 export { getPaginationViewModel, PAGE_SIZE_OPTIONS, MAX_PAGE_BUTTONS, } from './paginationHelpers';
 export type { PaginationViewModel } from './paginationHelpers';
 export { GRID_CONTEXT_MENU_ITEMS, COLUMN_HEADER_MENU_ITEMS, getContextMenuHandlers, getColumnHeaderMenuItems, formatShortcut } from './gridContextMenuHelpers';
-export type { CsvColumn } from './exportToCsv';
+export type { CsvColumn, FormulaExportOptions } from './exportToCsv';
 export type { StatusBarPart, StatusBarPartsInput } from './statusBarHelpers';
 export type { GridContextMenuItem, IColumnHeaderMenuItem, GridContextMenuHandlerProps, ColumnHeaderMenuInput, ColumnHeaderMenuHandlers } from './gridContextMenuHelpers';
 export { parseValue, numberParser, currencyParser, dateParser, emailParser, booleanParser, } from './valueParsers';
@@ -36,5 +36,7 @@ export type { ArrowNavigationContext, ArrowNavigationResult } from './keyboardNa
 export { rangesEqual, clampSelectionToBounds, computeAutoScrollSpeed, applyRangeRowSelection, computeRowSelectionState } from './selectionHelpers';
 export { formatCellValueForTsv, formatSelectionAsTsv, parseTsvClipboard, applyPastedValues, applyCutClear, } from './clipboardHelpers';
 export { applyFillValues } from './fillHelpers';
+export type { IFillFormulaOptions } from './fillHelpers';
 export { UndoRedoStack } from './undoRedoStack';
 export { validateColumns, validateRowIds, validateVirtualScrollConfig } from './validation';
+export { indexToColumnLetter, formatCellReference } from './cellReference';

package/package.json

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