@alaarab/ogrid-react 2.1.15 → 2.3.0

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-import * as React4 from 'react';
+import * as React5 from 'react';
 import { useRef, useState, useCallback, useEffect, useMemo, useImperativeHandle, useLayoutEffect, forwardRef } from 'react';
 import { createPortal, flushSync } from 'react-dom';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -41,14 +41,23 @@ function escapeCsvValue(value) {
 function buildCsvHeader(columns) {
   return columns.map((c) => escapeCsvValue(c.name)).join(",");
 }
-function buildCsvRows(items, columns, getValue) {
+function buildCsvRows(items, columns, getValue, formulaOptions) {
   return items.map(
-    (item) => columns.map((c) => escapeCsvValue(getValue(item, c.columnId))).join(",")
+    (item, rowIdx) => columns.map((col) => {
+      if (formulaOptions?.exportMode === "formulas" && formulaOptions.hasFormula && formulaOptions.getFormula && formulaOptions.columnIdToIndex) {
+        const colIdx = formulaOptions.columnIdToIndex.get(col.columnId);
+        if (colIdx !== void 0 && formulaOptions.hasFormula(colIdx, rowIdx)) {
+          const formula = formulaOptions.getFormula(colIdx, rowIdx);
+          if (formula) return escapeCsvValue(formula);
+        }
+      }
+      return escapeCsvValue(getValue(item, col.columnId));
+    }).join(",")
   );
 }
-function exportToCsv(items, columns, getValue, filename) {
+function exportToCsv(items, columns, getValue, filename, formulaOptions) {
   const header = buildCsvHeader(columns);
-  const rows = buildCsvRows(items, columns, getValue);
+  const rows = buildCsvRows(items, columns, getValue, formulaOptions);
   const csv = [header, ...rows].join("\n");
   triggerCsvDownload(csv, filename ?? `export_${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.csv`);
 }
@@ -715,6 +724,305 @@ function calculateDropTarget(params) {
   }
   return { targetIndex, indicatorX };
 }
+function computeVisibleColumnRange(scrollLeft, columnWidths, containerWidth, overscan = 2) {
+  if (columnWidths.length === 0 || containerWidth <= 0) {
+    return { startIndex: 0, endIndex: -1, leftOffset: 0, rightOffset: 0 };
+  }
+  let cumWidth = 0;
+  let rawStart = columnWidths.length;
+  let rawEnd = -1;
+  for (let i = 0; i < columnWidths.length; i++) {
+    const colStart = cumWidth;
+    cumWidth += columnWidths[i];
+    if (cumWidth > scrollLeft && rawStart === columnWidths.length) {
+      rawStart = i;
+    }
+    if (colStart < scrollLeft + containerWidth) {
+      rawEnd = i;
+    }
+  }
+  if (rawStart > rawEnd) {
+    return { startIndex: 0, endIndex: -1, leftOffset: 0, rightOffset: 0 };
+  }
+  const startIndex = Math.max(0, rawStart - overscan);
+  const endIndex = Math.min(columnWidths.length - 1, rawEnd + overscan);
+  let leftOffset = 0;
+  for (let i = 0; i < startIndex; i++) {
+    leftOffset += columnWidths[i];
+  }
+  let rightOffset = 0;
+  for (let i = endIndex + 1; i < columnWidths.length; i++) {
+    rightOffset += columnWidths[i];
+  }
+  return { startIndex, endIndex, leftOffset, rightOffset };
+}
+function partitionColumnsForVirtualization(visibleCols, columnRange, pinnedColumns) {
+  const pinnedLeft = [];
+  const pinnedRight = [];
+  const unpinned = [];
+  for (const col of visibleCols) {
+    const pin = pinnedColumns?.[col.columnId];
+    if (pin === "left") pinnedLeft.push(col);
+    else if (pin === "right") pinnedRight.push(col);
+    else unpinned.push(col);
+  }
+  if (!columnRange || columnRange.endIndex < 0) {
+    return {
+      pinnedLeft,
+      virtualizedUnpinned: unpinned,
+      pinnedRight,
+      leftSpacerWidth: 0,
+      rightSpacerWidth: 0
+    };
+  }
+  const virtualizedUnpinned = unpinned.slice(columnRange.startIndex, columnRange.endIndex + 1);
+  return {
+    pinnedLeft,
+    virtualizedUnpinned,
+    pinnedRight,
+    leftSpacerWidth: columnRange.leftOffset,
+    rightSpacerWidth: columnRange.rightOffset
+  };
+}
+function getScrollTopForRow(rowIndex, rowHeight, containerHeight, align = "start") {
+  const rowTop = rowIndex * rowHeight;
+  switch (align) {
+    case "start":
+      return rowTop;
+    case "center":
+      return Math.max(0, rowTop - (containerHeight - rowHeight) / 2);
+    case "end":
+      return Math.max(0, rowTop - containerHeight + rowHeight);
+  }
+}
+function workerBody() {
+  const ctx = self;
+  ctx.onmessage = (e) => {
+    const msg = e.data;
+    if (msg.type !== "sort-filter") return;
+    const { requestId, values, filters, sort } = msg;
+    const rowCount = values.length;
+    let indices = [];
+    const filterEntries = Object.entries(filters);
+    if (filterEntries.length === 0) {
+      indices = new Array(rowCount);
+      for (let i = 0; i < rowCount; i++) indices[i] = i;
+    } else {
+      for (let r = 0; r < rowCount; r++) {
+        let pass = true;
+        for (let f = 0; f < filterEntries.length; f++) {
+          const colIdx = Number(filterEntries[f][0]);
+          const filter = filterEntries[f][1];
+          const cellVal = values[r][colIdx];
+          switch (filter.type) {
+            case "text": {
+              const trimmed = filter.value.trim().toLowerCase();
+              if (trimmed && !String(cellVal ?? "").toLowerCase().includes(trimmed)) {
+                pass = false;
+              }
+              break;
+            }
+            case "multiSelect": {
+              if (filter.value.length > 0) {
+                const set = new Set(filter.value);
+                if (!set.has(String(cellVal ?? ""))) {
+                  pass = false;
+                }
+              }
+              break;
+            }
+            case "date": {
+              if (cellVal == null) {
+                pass = false;
+                break;
+              }
+              const ts = new Date(String(cellVal)).getTime();
+              if (isNaN(ts)) {
+                pass = false;
+                break;
+              }
+              if (filter.value.from) {
+                const fromTs = (/* @__PURE__ */ new Date(filter.value.from + "T00:00:00")).getTime();
+                if (ts < fromTs) {
+                  pass = false;
+                  break;
+                }
+              }
+              if (filter.value.to) {
+                const toTs = (/* @__PURE__ */ new Date(filter.value.to + "T23:59:59.999")).getTime();
+                if (ts > toTs) {
+                  pass = false;
+                  break;
+                }
+              }
+              break;
+            }
+          }
+          if (!pass) break;
+        }
+        if (pass) indices.push(r);
+      }
+    }
+    if (sort) {
+      const { columnIndex, direction } = sort;
+      const dir = direction === "asc" ? 1 : -1;
+      indices.sort((a, b) => {
+        const av = values[a][columnIndex];
+        const bv = values[b][columnIndex];
+        if (av == null && bv == null) return 0;
+        if (av == null) return -1 * dir;
+        if (bv == null) return 1 * dir;
+        if (typeof av === "number" && typeof bv === "number") {
+          return av === bv ? 0 : av > bv ? dir : -dir;
+        }
+        const sa = String(av).toLowerCase();
+        const sb = String(bv).toLowerCase();
+        return sa === sb ? 0 : sa > sb ? dir : -dir;
+      });
+    }
+    const response = {
+      type: "sort-filter-result",
+      requestId,
+      indices
+    };
+    ctx.postMessage(response);
+  };
+}
+var workerInstance = null;
+var requestCounter = 0;
+var pendingRequests = /* @__PURE__ */ new Map();
+function createSortFilterWorker() {
+  if (workerInstance) return workerInstance;
+  if (typeof Worker === "undefined" || typeof Blob === "undefined" || typeof URL === "undefined") {
+    return null;
+  }
+  try {
+    const fnStr = workerBody.toString();
+    const blob = new Blob(
+      [`(${fnStr})()`],
+      { type: "application/javascript" }
+    );
+    const url = URL.createObjectURL(blob);
+    workerInstance = new Worker(url);
+    URL.revokeObjectURL(url);
+    workerInstance.onmessage = (e) => {
+      const { requestId, indices } = e.data;
+      const pending = pendingRequests.get(requestId);
+      if (pending) {
+        pendingRequests.delete(requestId);
+        pending.resolve(indices);
+      }
+    };
+    workerInstance.onerror = (err) => {
+      for (const [id, pending] of pendingRequests) {
+        pending.reject(new Error(err.message || "Worker error"));
+        pendingRequests.delete(id);
+      }
+    };
+    return workerInstance;
+  } catch {
+    return null;
+  }
+}
+function extractValueMatrix(data, columns) {
+  const matrix = new Array(data.length);
+  for (let r = 0; r < data.length; r++) {
+    const row = new Array(columns.length);
+    for (let c = 0; c < columns.length; c++) {
+      const val = getCellValue(data[r], columns[c]);
+      if (val == null) {
+        row[c] = null;
+      } else if (typeof val === "string" || typeof val === "number" || typeof val === "boolean") {
+        row[c] = val;
+      } else {
+        row[c] = String(val);
+      }
+    }
+    matrix[r] = row;
+  }
+  return matrix;
+}
+function processClientSideDataAsync(data, columns, filters, sortBy, sortDirection) {
+  if (sortBy) {
+    const sortCol = columns.find((c) => c.columnId === sortBy);
+    if (sortCol?.compare) {
+      return Promise.resolve(processClientSideData(data, columns, filters, sortBy, sortDirection));
+    }
+  }
+  const worker = createSortFilterWorker();
+  if (!worker) {
+    return Promise.resolve(processClientSideData(data, columns, filters, sortBy, sortDirection));
+  }
+  const columnIndexMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < columns.length; i++) {
+    columnIndexMap.set(columns[i].columnId, i);
+  }
+  const values = extractValueMatrix(data, columns);
+  const columnMeta = columns.map((col, idx) => ({
+    type: col.type ?? "text",
+    index: idx
+  }));
+  const workerFilters = {};
+  for (const col of columns) {
+    const filterKey = getFilterField(col);
+    const val = filters[filterKey];
+    if (!val) continue;
+    const colIdx = columnIndexMap.get(col.columnId);
+    if (colIdx === void 0) continue;
+    switch (val.type) {
+      case "text":
+        workerFilters[colIdx] = { type: "text", value: val.value };
+        break;
+      case "multiSelect":
+        workerFilters[colIdx] = { type: "multiSelect", value: val.value };
+        break;
+      case "date":
+        workerFilters[colIdx] = { type: "date", value: { from: val.value.from, to: val.value.to } };
+        break;
+      // 'people' filter has a UserLike object — fall back to sync
+      case "people":
+        return Promise.resolve(processClientSideData(data, columns, filters, sortBy, sortDirection));
+    }
+  }
+  let sort;
+  if (sortBy) {
+    const sortColIdx = columnIndexMap.get(sortBy);
+    if (sortColIdx !== void 0) {
+      sort = { columnIndex: sortColIdx, direction: sortDirection ?? "asc" };
+    }
+  }
+  const requestId = ++requestCounter;
+  return new Promise((resolve, reject) => {
+    pendingRequests.set(requestId, {
+      resolve: (indices) => {
+        const result = new Array(indices.length);
+        for (let i = 0; i < indices.length; i++) {
+          result[i] = data[indices[i]];
+        }
+        resolve(result);
+      },
+      reject
+    });
+    const request = {
+      type: "sort-filter",
+      requestId,
+      values,
+      columnMeta,
+      filters: workerFilters,
+      sort
+    };
+    worker.postMessage(request);
+  });
+}
+var FormulaError = class {
+  constructor(type, message) {
+    this.type = type;
+    this.message = message;
+  }
+  toString() {
+    return this.type;
+  }
+};
 function getHeaderFilterConfig(col, input) {
   const filterable = isFilterConfig(col.filterable) ? col.filterable : null;
   const filterType = filterable?.type ?? "none";
@@ -841,7 +1149,8 @@ function computeCellDescriptor(item, col, rowIndex, colIdx, input) {
   const canEditAny = canEditInline || canEditPopup;
   const isEditing = input.editingCell?.rowId === rowId && input.editingCell?.columnId === col.columnId;
   const isActive = !input.isDragging && input.activeCell?.rowIndex === rowIndex && input.activeCell?.columnIndex === globalColIndex;
-  const isInRange = input.selectionRange != null && isInSelectionRange(input.selectionRange, rowIndex, colIdx);
+  const isSingleCellRange = input.selectionRange != null && input.selectionRange.startRow === input.selectionRange.endRow && input.selectionRange.startCol === input.selectionRange.endCol;
+  const isInRange = input.selectionRange != null && !isSingleCellRange && isInSelectionRange(input.selectionRange, rowIndex, colIdx);
   const isInCutRange = input.cutRange != null && isInSelectionRange(input.cutRange, rowIndex, colIdx);
   const isInCopyRange = input.copyRange != null && isInSelectionRange(input.copyRange, rowIndex, colIdx);
   const isSelectionEndCell = !input.isDragging && input.copyRange == null && input.cutRange == null && input.selectionRange != null && rowIndex === input.selectionRange.endRow && colIdx === input.selectionRange.endCol;
@@ -883,6 +1192,9 @@ function computeCellDescriptor(item, col, rowIndex, colIdx, input) {
   };
 }
 function resolveCellDisplayContent(col, item, displayValue) {
+  if (displayValue instanceof FormulaError) {
+    return displayValue.toString();
+  }
   const c = col;
   if (c.renderCell && typeof c.renderCell === "function") {
     return c.renderCell(item);
@@ -898,10 +1210,14 @@ function resolveCellDisplayContent(col, item, displayValue) {
   }
   return String(displayValue);
 }
-function resolveCellStyle(col, item) {
+function resolveCellStyle(col, item, displayValue) {
   const c = col;
-  if (!c.cellStyle) return void 0;
-  return typeof c.cellStyle === "function" ? c.cellStyle(item) : c.cellStyle;
+  const isError = displayValue instanceof FormulaError;
+  const base = c.cellStyle ? typeof c.cellStyle === "function" ? c.cellStyle(item) : c.cellStyle : void 0;
+  if (isError) {
+    return { ...base, color: "var(--ogrid-formula-error-color, #d32f2f)" };
+  }
+  return base;
 }
 function buildInlineEditorProps(item, col, descriptor, callbacks) {
   return {
@@ -992,6 +1308,7 @@ var AUTOSIZE_MAX_PX = 520;
 function measureHeaderWidth(th) {
   const cs = getComputedStyle(th);
   const thPadding = (parseFloat(cs.paddingLeft) || 0) + (parseFloat(cs.paddingRight) || 0);
+  const thBorders = (parseFloat(cs.borderLeftWidth) || 0) + (parseFloat(cs.borderRightWidth) || 0);
   let resizeHandleWidth = 0;
   for (let i = 0; i < th.children.length; i++) {
     const child = th.children[i];
@@ -1014,12 +1331,14 @@ function measureHeaderWidth(th) {
           overflow: child.style.overflow,
           flexShrink: child.style.flexShrink,
           width: child.style.width,
-          minWidth: child.style.minWidth
+          minWidth: child.style.minWidth,
+          maxWidth: child.style.maxWidth
         });
         child.style.overflow = "visible";
         child.style.flexShrink = "0";
         child.style.width = "max-content";
         child.style.minWidth = "max-content";
+        child.style.maxWidth = "none";
       }
       expandDescendants(child);
     }
@@ -1037,8 +1356,9 @@ function measureHeaderWidth(th) {
     m.el.style.flexShrink = m.flexShrink;
     m.el.style.width = m.width;
     m.el.style.minWidth = m.minWidth;
+    m.el.style.maxWidth = m.maxWidth;
   }
-  return expandedWidth + resizeHandleWidth + thPadding;
+  return expandedWidth + resizeHandleWidth + thPadding + thBorders;
 }
 function measureColumnContentWidth(columnId, minWidth, container) {
   const minW = minWidth ?? DEFAULT_MIN_COLUMN_WIDTH;
@@ -1249,7 +1569,7 @@ function formatCellValueForTsv(raw, formatted) {
     return "[Object]";
   }
 }
-function formatSelectionAsTsv(items, visibleCols, range) {
+function formatSelectionAsTsv(items, visibleCols, range, formulaOptions) {
   const norm = normalizeSelectionRange(range);
   const rows = [];
   for (let r = norm.startRow; r <= norm.endRow; r++) {
@@ -1258,6 +1578,16 @@ function formatSelectionAsTsv(items, visibleCols, range) {
       if (r >= items.length || c >= visibleCols.length) break;
       const item = items[r];
       const col = visibleCols[c];
+      if (formulaOptions?.hasFormula && formulaOptions?.getFormula) {
+        const flatColIndex = formulaOptions.flatColumns.findIndex((fc) => fc.columnId === col.columnId);
+        if (flatColIndex >= 0 && formulaOptions.hasFormula(flatColIndex, r)) {
+          const formulaStr = formulaOptions.getFormula(flatColIndex, r);
+          if (formulaStr) {
+            cells.push(formulaStr);
+            continue;
+          }
+        }
+      }
       const raw = getCellValue(item, col);
       const clipboard = col.clipboardFormatter ? col.clipboardFormatter(raw, item) : null;
       const formatted = clipboard ?? (col.valueFormatter ? col.valueFormatter(raw, item) : raw);
@@ -1272,7 +1602,7 @@ function parseTsvClipboard(text) {
   const lines = text.split(/\r?\n/).filter((l) => l.length > 0);
   return lines.map((line) => line.split("	"));
 }
-function applyPastedValues(parsedRows, anchorRow, anchorCol, items, visibleCols) {
+function applyPastedValues(parsedRows, anchorRow, anchorCol, items, visibleCols, formulaOptions) {
   const events = [];
   for (let r = 0; r < parsedRows.length; r++) {
     const cells = parsedRows[r];
@@ -1283,9 +1613,16 @@ function applyPastedValues(parsedRows, anchorRow, anchorCol, items, visibleCols)
       const item = items[targetRow];
       const col = visibleCols[targetCol];
       if (!isColumnEditable(col, item)) continue;
-      const rawValue = cells[c] ?? "";
+      const cellText = cells[c] ?? "";
+      if (cellText.startsWith("=") && formulaOptions?.setFormula) {
+        const flatColIndex = formulaOptions.flatColumns.findIndex((fc) => fc.columnId === col.columnId);
+        if (flatColIndex >= 0) {
+          formulaOptions.setFormula(flatColIndex, targetRow, cellText);
+          continue;
+        }
+      }
       const oldValue = getCellValue(item, col);
-      const result = parseValue(rawValue, oldValue, item, col);
+      const result = parseValue(cellText, oldValue, item, col);
       if (!result.valid) continue;
       events.push({
         item,
@@ -1320,12 +1657,101 @@ function applyCutClear(cutRange, items, visibleCols) {
   }
   return events;
 }
-function applyFillValues(range, sourceRow, sourceCol, items, visibleCols) {
+function indexToColumnLetter(index) {
+  let result = "";
+  let n = index;
+  while (n >= 0) {
+    result = String.fromCharCode(n % 26 + 65) + result;
+    n = Math.floor(n / 26) - 1;
+  }
+  return result;
+}
+function formatCellReference(colIndex, rowNumber) {
+  return `${indexToColumnLetter(colIndex)}${rowNumber}`;
+}
+function columnLetterToIndex(letters) {
+  let result = 0;
+  const upper = letters.toUpperCase();
+  for (let i = 0; i < upper.length; i++) {
+    result = result * 26 + (upper.charCodeAt(i) - 64);
+  }
+  return result - 1;
+}
+var CELL_REF_RE = /^(\$?)([A-Za-z]+)(\$?)(\d+)$/;
+var ADJUST_REF_RE = /(?:'[^']*'!|[A-Za-z_]\w*!)?(\$?)([A-Z]+)(\$?)(\d+)/g;
+function parseCellRef(ref) {
+  const m = ref.match(CELL_REF_RE);
+  if (!m) return null;
+  const absCol = m[1] === "$";
+  const colLetters = m[2];
+  const absRow = m[3] === "$";
+  const rowNum = parseInt(m[4], 10);
+  if (rowNum < 1) return null;
+  return {
+    col: columnLetterToIndex(colLetters),
+    row: rowNum - 1,
+    // 0-based internally
+    absCol,
+    absRow
+  };
+}
+function parseRange(rangeStr) {
+  const parts = rangeStr.split(":");
+  if (parts.length !== 2) return null;
+  const start = parseCellRef(parts[0]);
+  const end = parseCellRef(parts[1]);
+  if (!start || !end) return null;
+  return { start, end };
+}
+function adjustFormulaReferences(formula, colDelta, rowDelta) {
+  ADJUST_REF_RE.lastIndex = 0;
+  return formula.replace(ADJUST_REF_RE, (match, colAbs, colLetters, rowAbs, rowDigits) => {
+    const cellRefStart = match.indexOf(colAbs + colLetters);
+    const sheetPrefix = cellRefStart > 0 ? match.substring(0, cellRefStart) : "";
+    let newCol = colLetters;
+    let newRow = rowDigits;
+    if (colAbs !== "$") {
+      const colIdx = columnLetterToIndex(colLetters) + colDelta;
+      if (colIdx < 0) return "#REF!";
+      newCol = indexToColumnLetter(colIdx);
+    }
+    if (rowAbs !== "$") {
+      const rowNum = parseInt(rowDigits, 10) + rowDelta;
+      if (rowNum < 1) return "#REF!";
+      newRow = String(rowNum);
+    }
+    return `${sheetPrefix}${colAbs}${newCol}${rowAbs}${newRow}`;
+  });
+}
+function toCellKey(col, row, sheet) {
+  if (sheet) return `${sheet}:${col},${row}`;
+  return `${col},${row}`;
+}
+function fromCellKey(key) {
+  const colonIdx = key.indexOf(":");
+  if (colonIdx >= 0 && isNaN(parseInt(key.substring(0, colonIdx), 10))) {
+    const sheet = key.substring(0, colonIdx);
+    const rest = key.substring(colonIdx + 1);
+    const commaIdx = rest.indexOf(",");
+    return {
+      col: parseInt(rest.substring(0, commaIdx), 10),
+      row: parseInt(rest.substring(commaIdx + 1), 10),
+      sheet
+    };
+  }
+  const i = key.indexOf(",");
+  return {
+    col: parseInt(key.substring(0, i), 10),
+    row: parseInt(key.substring(i + 1), 10)
+  };
+}
+function applyFillValues(range, sourceRow, sourceCol, items, visibleCols, formulaOptions) {
   const events = [];
   const startItem = items[range.startRow];
   const startColDef = visibleCols[range.startCol];
   if (!startItem || !startColDef) return events;
   const startValue = getCellValue(startItem, startColDef);
+  const srcFlatColIndex = formulaOptions ? formulaOptions.flatColumns.findIndex((c) => c.columnId === startColDef.columnId) : -1;
   for (let row = range.startRow; row <= range.endRow; row++) {
     for (let col = range.startCol; col <= range.endCol; col++) {
       if (row === sourceRow && col === sourceCol) continue;
@@ -1333,6 +1759,19 @@ function applyFillValues(range, sourceRow, sourceCol, items, visibleCols) {
       const item = items[row];
       const colDef = visibleCols[col];
       if (!isColumnEditable(colDef, item)) continue;
+      if (formulaOptions && formulaOptions.hasFormula && formulaOptions.getFormula && formulaOptions.setFormula && srcFlatColIndex >= 0 && formulaOptions.hasFormula(srcFlatColIndex, sourceRow)) {
+        const srcFormula = formulaOptions.getFormula(srcFlatColIndex, sourceRow);
+        if (srcFormula) {
+          const rowDelta = row - sourceRow;
+          const colDelta = col - sourceCol;
+          const adjusted = adjustFormulaReferences(srcFormula, colDelta, rowDelta);
+          const targetFlatColIdx = formulaOptions.flatColumns.findIndex((c) => c.columnId === colDef.columnId);
+          if (targetFlatColIdx >= 0) {
+            formulaOptions.setFormula(targetFlatColIdx, row, adjusted);
+            continue;
+          }
+        }
+      }
       const oldValue = getCellValue(item, colDef);
       const result = parseValue(startValue, oldValue, item, colDef);
       if (!result.valid) continue;
@@ -1379,134 +1818,3307 @@ var UndoRedoStack = class {
    * If a batch is open, accumulates into the batch instead.
    * Clears the redo stack on any new entry.
    */
-  push(events) {
-    if (events.length === 0) return;
-    if (this.batch !== null) {
-      this.batch.push(...events);
-    } else {
-      this.history.push(events);
-      if (this.history.length > this.maxDepth) {
-        this.history.splice(0, this.history.length - this.maxDepth);
+  push(events) {
+    if (events.length === 0) return;
+    if (this.batch !== null) {
+      this.batch.push(...events);
+    } else {
+      this.history.push(events);
+      if (this.history.length > this.maxDepth) {
+        this.history.splice(0, this.history.length - this.maxDepth);
+      }
+      this.redoStack.length = 0;
+    }
+  }
+  /**
+   * Record a single event as a step (shorthand for push([event])).
+   * If a batch is open, accumulates into the batch instead.
+   */
+  record(event) {
+    this.push([event]);
+  }
+  /**
+   * Start a batch — subsequent record/push calls accumulate into one undo step.
+   * Has no effect if a batch is already open.
+   */
+  beginBatch() {
+    if (this.batch === null) {
+      this.batch = [];
+    }
+  }
+  /**
+   * End a batch — commits all accumulated events as one undo step.
+   * Has no effect if no batch is open or if the batch is empty.
+   */
+  endBatch() {
+    const b = this.batch;
+    this.batch = null;
+    if (!b || b.length === 0) return;
+    this.history.push(b);
+    if (this.history.length > this.maxDepth) {
+      this.history.splice(0, this.history.length - this.maxDepth);
+    }
+    this.redoStack.length = 0;
+  }
+  /**
+   * Pop the most recent history entry for undo.
+   * Returns the batch of events (in original order) to be reversed by the caller,
+   * or null if there is nothing to undo.
+   *
+   * The caller is responsible for applying the events in reverse order.
+   */
+  undo() {
+    const lastBatch = this.history.pop();
+    if (!lastBatch) return null;
+    this.redoStack.push(lastBatch);
+    return lastBatch;
+  }
+  /**
+   * Pop the most recent redo entry.
+   * Returns the batch of events (in original order) to be re-applied by the caller,
+   * or null if there is nothing to redo.
+   */
+  redo() {
+    const nextBatch = this.redoStack.pop();
+    if (!nextBatch) return null;
+    this.history.push(nextBatch);
+    return nextBatch;
+  }
+  /**
+   * Clear all history and redo state.
+   * Does not affect any open batch — call endBatch() first if needed.
+   */
+  clear() {
+    this.history = [];
+    this.redoStack = [];
+  }
+};
+function validateColumns(columns) {
+  if (!Array.isArray(columns) || columns.length === 0) {
+    console.warn("[OGrid] columns prop is empty or not an array");
+    return;
+  }
+  const isDev = typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
+  const ids = /* @__PURE__ */ new Set();
+  for (const col of columns) {
+    if (!col.columnId) {
+      console.warn("[OGrid] Column missing columnId:", col);
+    }
+    if (ids.has(col.columnId)) {
+      console.warn(`[OGrid] Duplicate columnId: "${col.columnId}"`);
+    }
+    ids.add(col.columnId);
+    if (isDev && col.editable === true && col.cellEditor == null) {
+      console.warn(
+        `[OGrid] Column "${col.columnId}" has editable=true but no cellEditor defined. Cells will not open an editor on double-click. Set cellEditor to 'text', 'select', 'checkbox', 'date', or a custom component.`
+      );
+    }
+  }
+}
+function validateVirtualScrollConfig(config) {
+  if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") return;
+  if (config.enabled !== true) return;
+  if (!config.rowHeight || config.rowHeight <= 0) {
+    console.warn(
+      "[OGrid] virtualScroll.enabled is true but rowHeight is missing or <= 0. Set a positive rowHeight (e.g. virtualScroll: { enabled: true, rowHeight: 36 }) for correct virtual scrolling behavior."
+    );
+  }
+}
+function validateRowIds(items, getRowId) {
+  if (typeof process !== "undefined" && process.env.NODE_ENV === "production") return;
+  if (!getRowId) return;
+  const ids = /* @__PURE__ */ new Set();
+  const limit = Math.min(items.length, 100);
+  for (let i = 0; i < limit; i++) {
+    const id = getRowId(items[i]);
+    if (id == null) {
+      console.warn(`[OGrid] getRowId returned null/undefined for row ${i}`);
+      return;
+    }
+    if (ids.has(id)) {
+      console.warn(
+        `[OGrid] Duplicate row ID "${id}" at index ${i}. getRowId must return unique values.`
+      );
+      return;
+    }
+    ids.add(id);
+  }
+}
+var DEFAULT_DEBOUNCE_MS = 300;
+var PEOPLE_SEARCH_DEBOUNCE_MS = DEFAULT_DEBOUNCE_MS;
+var CELL_REF_PATTERN = /^\$?[A-Za-z]+\$?\d+$/;
+var SINGLE_CHAR_OPERATORS = {
+  "+": "PLUS",
+  "-": "MINUS",
+  "*": "MULTIPLY",
+  "/": "DIVIDE",
+  "^": "POWER",
+  "%": "PERCENT",
+  "&": "AMPERSAND",
+  "=": "EQ"
+};
+var DELIMITERS = {
+  "(": "LPAREN",
+  ")": "RPAREN",
+  ",": "COMMA",
+  ":": "COLON"
+};
+function tokenize(input) {
+  const tokens = [];
+  let pos = 0;
+  while (pos < input.length) {
+    const ch = input[pos];
+    if (ch === " " || ch === "	" || ch === "\r" || ch === "\n") {
+      pos++;
+      continue;
+    }
+    if (ch >= "0" && ch <= "9" || ch === "." && pos + 1 < input.length && input[pos + 1] >= "0" && input[pos + 1] <= "9") {
+      const start = pos;
+      while (pos < input.length && input[pos] >= "0" && input[pos] <= "9") {
+        pos++;
+      }
+      if (pos < input.length && input[pos] === ".") {
+        pos++;
+        while (pos < input.length && input[pos] >= "0" && input[pos] <= "9") {
+          pos++;
+        }
+      }
+      tokens.push({ type: "NUMBER", value: input.slice(start, pos), position: start });
+      continue;
+    }
+    if (ch === "'") {
+      const start = pos;
+      pos++;
+      const nameStart = pos;
+      while (pos < input.length && input[pos] !== "'") {
+        pos++;
+      }
+      const sheetName = input.slice(nameStart, pos);
+      if (pos < input.length && input[pos] === "'") {
+        pos++;
+        if (pos < input.length && input[pos] === "!") {
+          pos++;
+          tokens.push({ type: "SHEET_REF", value: sheetName, position: start });
+          continue;
+        }
+      }
+      throw new FormulaError("#ERROR!", `Invalid sheet reference at position ${start}`);
+    }
+    if (ch === '"') {
+      const start = pos;
+      pos++;
+      const scanStart = pos;
+      let hasEscapes = false;
+      while (pos < input.length) {
+        if (input[pos] === '"') {
+          if (pos + 1 < input.length && input[pos + 1] === '"') {
+            hasEscapes = true;
+            pos += 2;
+          } else {
+            break;
+          }
+        } else {
+          pos++;
+        }
+      }
+      let value;
+      if (!hasEscapes) {
+        value = input.slice(scanStart, pos);
+      } else {
+        value = input.slice(scanStart, pos).replace(/""/g, '"');
+      }
+      if (pos < input.length) pos++;
+      tokens.push({ type: "STRING", value, position: start });
+      continue;
+    }
+    if (ch === ">" && pos + 1 < input.length && input[pos + 1] === "=") {
+      tokens.push({ type: "GTE", value: ">=", position: pos });
+      pos += 2;
+      continue;
+    }
+    if (ch === "<" && pos + 1 < input.length && input[pos + 1] === "=") {
+      tokens.push({ type: "LTE", value: "<=", position: pos });
+      pos += 2;
+      continue;
+    }
+    if (ch === "<" && pos + 1 < input.length && input[pos + 1] === ">") {
+      tokens.push({ type: "NEQ", value: "<>", position: pos });
+      pos += 2;
+      continue;
+    }
+    if (ch === ">" || ch === "<") {
+      const type = ch === ">" ? "GT" : "LT";
+      tokens.push({ type, value: ch, position: pos });
+      pos++;
+      continue;
+    }
+    if (SINGLE_CHAR_OPERATORS[ch]) {
+      tokens.push({ type: SINGLE_CHAR_OPERATORS[ch], value: ch, position: pos });
+      pos++;
+      continue;
+    }
+    if (DELIMITERS[ch]) {
+      tokens.push({ type: DELIMITERS[ch], value: ch, position: pos });
+      pos++;
+      continue;
+    }
+    if (ch === "$" || ch >= "A" && ch <= "Z" || ch >= "a" && ch <= "z") {
+      const start = pos;
+      while (pos < input.length && (input[pos] >= "A" && input[pos] <= "Z" || input[pos] >= "a" && input[pos] <= "z" || input[pos] >= "0" && input[pos] <= "9" || input[pos] === "$" || input[pos] === "_")) {
+        pos++;
+      }
+      const word = input.slice(start, pos);
+      if (pos < input.length && input[pos] === "!") {
+        pos++;
+        tokens.push({ type: "SHEET_REF", value: word, position: start });
+        continue;
+      }
+      if (pos < input.length && input[pos] === "(") {
+        tokens.push({ type: "FUNCTION", value: word, position: start });
+        continue;
+      }
+      const upper = word.toUpperCase();
+      if (upper === "TRUE" || upper === "FALSE") {
+        tokens.push({ type: "BOOLEAN", value: upper, position: start });
+        continue;
+      }
+      if (CELL_REF_PATTERN.test(word)) {
+        tokens.push({ type: "CELL_REF", value: word, position: start });
+        continue;
+      }
+      tokens.push({ type: "IDENTIFIER", value: word, position: start });
+      continue;
+    }
+    throw new FormulaError("#ERROR!", `Unexpected character: ${ch}`);
+  }
+  tokens.push({ type: "EOF", value: "", position: pos });
+  return tokens;
+}
+function parse(tokens, namedRanges) {
+  let pos = 0;
+  function peek() {
+    return tokens[pos];
+  }
+  function advance() {
+    const token = tokens[pos];
+    pos++;
+    return token;
+  }
+  function expect(type) {
+    const token = peek();
+    if (token && token.type === type) {
+      return advance();
+    }
+    return null;
+  }
+  function errorNode(message) {
+    return { kind: "error", error: new FormulaError("#ERROR!", message) };
+  }
+  function expression() {
+    return comparison();
+  }
+  function comparison() {
+    let left = concat();
+    while (peek()) {
+      const t = peek();
+      let op = null;
+      if (t.type === "GT") op = ">";
+      else if (t.type === "LT") op = "<";
+      else if (t.type === "GTE") op = ">=";
+      else if (t.type === "LTE") op = "<=";
+      else if (t.type === "EQ") op = "=";
+      else if (t.type === "NEQ") op = "<>";
+      else break;
+      advance();
+      const right = concat();
+      left = { kind: "binaryOp", op, left, right };
+    }
+    return left;
+  }
+  function concat() {
+    let left = addition();
+    while (peek() && peek().type === "AMPERSAND") {
+      advance();
+      const right = addition();
+      left = { kind: "binaryOp", op: "&", left, right };
+    }
+    return left;
+  }
+  function addition() {
+    let left = multiplication();
+    while (peek()) {
+      const t = peek();
+      let op = null;
+      if (t.type === "PLUS") op = "+";
+      else if (t.type === "MINUS") op = "-";
+      else break;
+      advance();
+      const right = multiplication();
+      left = { kind: "binaryOp", op, left, right };
+    }
+    return left;
+  }
+  function multiplication() {
+    let left = power();
+    while (peek()) {
+      const t = peek();
+      let op = null;
+      if (t.type === "MULTIPLY") op = "*";
+      else if (t.type === "DIVIDE") op = "/";
+      else break;
+      advance();
+      const right = power();
+      left = { kind: "binaryOp", op, left, right };
+    }
+    return left;
+  }
+  function power() {
+    let left = unary();
+    while (peek() && peek().type === "POWER") {
+      advance();
+      const right = unary();
+      left = { kind: "binaryOp", op: "^", left, right };
+    }
+    return left;
+  }
+  function unary() {
+    const t = peek();
+    if (t && (t.type === "MINUS" || t.type === "PLUS")) {
+      const op = t.type === "MINUS" ? "-" : "+";
+      advance();
+      const operand = unary();
+      return { kind: "unaryOp", op, operand };
+    }
+    return postfix();
+  }
+  function postfix() {
+    let node = primary();
+    if (peek() && peek().type === "PERCENT") {
+      advance();
+      node = { kind: "binaryOp", op: "%", left: node, right: { kind: "number", value: 100 } };
+    }
+    return node;
+  }
+  function primary() {
+    const t = peek();
+    if (!t || t.type === "EOF") {
+      return errorNode("Unexpected end of expression");
+    }
+    if (t.type === "NUMBER") {
+      advance();
+      return { kind: "number", value: parseFloat(t.value) };
+    }
+    if (t.type === "STRING") {
+      advance();
+      return { kind: "string", value: t.value };
+    }
+    if (t.type === "BOOLEAN") {
+      advance();
+      return { kind: "boolean", value: t.value.toUpperCase() === "TRUE" };
+    }
+    if (t.type === "CELL_REF") {
+      return cellRefOrRange();
+    }
+    if (t.type === "FUNCTION") {
+      return functionCall();
+    }
+    if (t.type === "IDENTIFIER") {
+      return namedRangeRef();
+    }
+    if (t.type === "SHEET_REF") {
+      return sheetRef();
+    }
+    if (t.type === "LPAREN") {
+      advance();
+      const node = expression();
+      if (!expect("RPAREN")) {
+        return errorNode("Expected closing parenthesis");
+      }
+      return node;
+    }
+    advance();
+    return errorNode(`Unexpected token: ${t.value}`);
+  }
+  function cellRefOrRange() {
+    const refToken = advance();
+    const address = parseCellRef(refToken.value);
+    if (!address) {
+      return errorNode(`Invalid cell reference: ${refToken.value}`);
+    }
+    if (peek() && peek().type === "COLON") {
+      advance();
+      const endToken = expect("CELL_REF");
+      if (!endToken) {
+        return errorNode('Expected cell reference after ":"');
+      }
+      const endAddress = parseCellRef(endToken.value);
+      if (!endAddress) {
+        return errorNode(`Invalid cell reference: ${endToken.value}`);
+      }
+      return {
+        kind: "range",
+        start: address,
+        end: endAddress,
+        raw: `${refToken.value}:${endToken.value}`
+      };
+    }
+    return {
+      kind: "cellRef",
+      address,
+      raw: refToken.value
+    };
+  }
+  function functionCall() {
+    const nameToken = advance();
+    const name = nameToken.value.toUpperCase();
+    if (!expect("LPAREN")) {
+      return errorNode(`Expected "(" after function name "${name}"`);
+    }
+    const args = [];
+    if (peek() && peek().type !== "RPAREN" && peek().type !== "EOF") {
+      args.push(expression());
+      while (peek() && peek().type === "COMMA") {
+        advance();
+        args.push(expression());
+      }
+    }
+    if (!expect("RPAREN")) {
+      return errorNode(`Expected ")" after function arguments for "${name}"`);
+    }
+    return { kind: "functionCall", name, args };
+  }
+  function namedRangeRef() {
+    const nameToken = advance();
+    const name = nameToken.value.toUpperCase();
+    const ref = namedRanges?.get(name);
+    if (!ref) {
+      return { kind: "error", error: new FormulaError("#NAME?", `Unknown name: ${nameToken.value}`) };
+    }
+    if (ref.includes(":")) {
+      const rangeRef = parseRange(ref);
+      if (rangeRef) {
+        return { kind: "range", start: rangeRef.start, end: rangeRef.end, raw: ref };
+      }
+    }
+    const cellRef = parseCellRef(ref);
+    if (cellRef) {
+      return { kind: "cellRef", address: cellRef, raw: ref };
+    }
+    return { kind: "error", error: new FormulaError("#REF!", `Invalid named range reference: ${ref}`) };
+  }
+  function sheetRef() {
+    const sheetToken = advance();
+    const sheetName = sheetToken.value;
+    const cellToken = expect("CELL_REF");
+    if (!cellToken) {
+      return errorNode(`Expected cell reference after sheet "${sheetName}!"`);
+    }
+    const address = parseCellRef(cellToken.value);
+    if (!address) {
+      return errorNode(`Invalid cell reference: ${cellToken.value}`);
+    }
+    address.sheet = sheetName;
+    if (peek() && peek().type === "COLON") {
+      advance();
+      const endToken = expect("CELL_REF");
+      if (!endToken) {
+        return errorNode('Expected cell reference after ":"');
+      }
+      const endAddress = parseCellRef(endToken.value);
+      if (!endAddress) {
+        return errorNode(`Invalid cell reference: ${endToken.value}`);
+      }
+      endAddress.sheet = sheetName;
+      return {
+        kind: "range",
+        start: address,
+        end: endAddress,
+        raw: `${sheetName}!${cellToken.value}:${endToken.value}`
+      };
+    }
+    return {
+      kind: "cellRef",
+      address,
+      raw: `${sheetName}!${cellToken.value}`
+    };
+  }
+  const result = expression();
+  if (peek() && peek().type !== "EOF") {
+    return errorNode(`Unexpected token after expression: ${peek().value}`);
+  }
+  return result;
+}
+function toNumber(val) {
+  if (val instanceof FormulaError) return val;
+  if (val === null || val === void 0 || val === "") return 0;
+  if (typeof val === "boolean") return val ? 1 : 0;
+  if (typeof val === "number") return val;
+  if (val instanceof Date) return val.getTime();
+  const n = Number(val);
+  if (isNaN(n)) return new FormulaError("#VALUE!", `Cannot convert "${val}" to number`);
+  return n;
+}
+function toString(val) {
+  if (val === null || val === void 0) return "";
+  if (val instanceof FormulaError) return val.toString();
+  if (val instanceof Date) return val.toLocaleDateString();
+  return String(val);
+}
+function flattenArgs(args, context, evaluator) {
+  const result = [];
+  for (const arg of args) {
+    if (arg.kind === "range") {
+      const values = context.getRangeValues({ start: arg.start, end: arg.end });
+      for (const row of values) {
+        for (const val of row) {
+          result.push(val);
+        }
+      }
+    } else {
+      result.push(evaluator.evaluate(arg, context));
+    }
+  }
+  return result;
+}
+var FormulaEvaluator = class {
+  constructor(builtInFunctions) {
+    this.functions = new Map(builtInFunctions);
+  }
+  registerFunction(name, fn) {
+    this.functions.set(name.toUpperCase(), fn);
+  }
+  evaluate(node, context) {
+    switch (node.kind) {
+      case "number":
+        return node.value;
+      case "string":
+        return node.value;
+      case "boolean":
+        return node.value;
+      case "error":
+        return node.error;
+      case "cellRef": {
+        const val = context.getCellValue(node.address);
+        return val;
+      }
+      case "range":
+        return context.getCellValue(node.start);
+      case "functionCall":
+        return this.evaluateFunction(node.name, node.args, context);
+      case "binaryOp":
+        return this.evaluateBinaryOp(node.op, node.left, node.right, context);
+      case "unaryOp":
+        return this.evaluateUnaryOp(node.op, node.operand, context);
+    }
+  }
+  evaluateFunction(name, args, context) {
+    const fn = this.functions.get(name);
+    if (!fn) {
+      return new FormulaError("#NAME?", `Unknown function: ${name}`);
+    }
+    if (args.length < fn.minArgs) {
+      return new FormulaError("#ERROR!", `${name} requires at least ${fn.minArgs} argument(s)`);
+    }
+    if (fn.maxArgs >= 0 && args.length > fn.maxArgs) {
+      return new FormulaError("#ERROR!", `${name} accepts at most ${fn.maxArgs} argument(s)`);
+    }
+    return fn.evaluate(args, context, this);
+  }
+  evaluateBinaryOp(op, left, right, context) {
+    if (op === "&") {
+      const l = this.evaluate(left, context);
+      if (l instanceof FormulaError) return l;
+      const r = this.evaluate(right, context);
+      if (r instanceof FormulaError) return r;
+      return toString(l) + toString(r);
+    }
+    if (op === ">" || op === "<" || op === ">=" || op === "<=" || op === "=" || op === "<>") {
+      const l = this.evaluate(left, context);
+      if (l instanceof FormulaError) return l;
+      const r = this.evaluate(right, context);
+      if (r instanceof FormulaError) return r;
+      return this.compare(op, l, r);
+    }
+    const lVal = this.evaluate(left, context);
+    if (lVal instanceof FormulaError) return lVal;
+    const rVal = this.evaluate(right, context);
+    if (rVal instanceof FormulaError) return rVal;
+    const lNum = toNumber(lVal);
+    if (lNum instanceof FormulaError) return lNum;
+    const rNum = toNumber(rVal);
+    if (rNum instanceof FormulaError) return rNum;
+    switch (op) {
+      case "+":
+        return lNum + rNum;
+      case "-":
+        return lNum - rNum;
+      case "*":
+        return lNum * rNum;
+      case "/":
+        if (rNum === 0) return new FormulaError("#DIV/0!");
+        return lNum / rNum;
+      case "^":
+        return Math.pow(lNum, rNum);
+      case "%":
+        return lNum * rNum / 100;
+      default:
+        return new FormulaError("#ERROR!", `Unknown operator: ${op}`);
+    }
+  }
+  evaluateUnaryOp(op, operand, context) {
+    const val = this.evaluate(operand, context);
+    if (val instanceof FormulaError) return val;
+    const num = toNumber(val);
+    if (num instanceof FormulaError) return num;
+    return op === "-" ? -num : num;
+  }
+  compare(op, left, right) {
+    if (typeof left === "number" && typeof right === "number") {
+      return this.numCompare(op, left, right);
+    }
+    if (typeof left === "string" && typeof right === "string") {
+      return this.strCompare(op, left, right);
+    }
+    if (typeof left === "boolean" && typeof right === "boolean") {
+      return this.numCompare(op, left ? 1 : 0, right ? 1 : 0);
+    }
+    const lNum = toNumber(left);
+    const rNum = toNumber(right);
+    if (typeof lNum === "number" && typeof rNum === "number") {
+      return this.numCompare(op, lNum, rNum);
+    }
+    return this.strCompare(op, toString(left), toString(right));
+  }
+  numCompare(op, a, b) {
+    switch (op) {
+      case ">":
+        return a > b;
+      case "<":
+        return a < b;
+      case ">=":
+        return a >= b;
+      case "<=":
+        return a <= b;
+      case "=":
+        return a === b;
+      case "<>":
+        return a !== b;
+      default:
+        return false;
+    }
+  }
+  strCompare(op, a, b) {
+    const al = a.toLowerCase();
+    const bl = b.toLowerCase();
+    switch (op) {
+      case ">":
+        return al > bl;
+      case "<":
+        return al < bl;
+      case ">=":
+        return al >= bl;
+      case "<=":
+        return al <= bl;
+      case "=":
+        return al === bl;
+      case "<>":
+        return al !== bl;
+      default:
+        return false;
+    }
+  }
+};
+var EMPTY_SET = Object.freeze(/* @__PURE__ */ new Set());
+var DependencyGraph = class {
+  constructor() {
+    this.dependencies = /* @__PURE__ */ new Map();
+    this.dependents = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Set the dependencies for a cell, replacing any previous ones.
+   * Updates both the forward (dependencies) and reverse (dependents) maps.
+   */
+  setDependencies(cell, deps) {
+    this.removeDependenciesInternal(cell);
+    this.dependencies.set(cell, deps);
+    for (const dep of deps) {
+      let depSet = this.dependents.get(dep);
+      if (!depSet) {
+        depSet = /* @__PURE__ */ new Set();
+        this.dependents.set(dep, depSet);
+      }
+      depSet.add(cell);
+    }
+  }
+  /**
+   * Remove all dependency information for a cell from both maps.
+   */
+  removeDependencies(cell) {
+    this.removeDependenciesInternal(cell);
+    this.dependencies.delete(cell);
+  }
+  /**
+   * Get all cells that directly or transitively depend on `changedCell`,
+   * returned in topological order (a cell appears AFTER all cells it depends on).
+   *
+   * Uses Kahn's algorithm. If a cycle is detected, cycle participants are
+   * appended at the end (the engine will assign #CIRC! to them).
+   */
+  getRecalcOrder(changedCell) {
+    return this.topologicalSort(/* @__PURE__ */ new Set([changedCell]));
+  }
+  /**
+   * Same as getRecalcOrder but for multiple changed cells.
+   * Union of all transitive dependents, topologically sorted.
+   */
+  getRecalcOrderBatch(changedCells) {
+    return this.topologicalSort(new Set(changedCells));
+  }
+  /**
+   * Check if adding dependencies from `cell` to `deps` would create a cycle.
+   * DFS from each dep: if we can reach `cell`, it would create a cycle.
+   */
+  wouldCreateCycle(cell, deps) {
+    if (deps.has(cell)) {
+      return true;
+    }
+    const visited = /* @__PURE__ */ new Set();
+    for (const dep of deps) {
+      if (this.canReach(dep, cell, visited)) {
+        return true;
+      }
+    }
+    return false;
+  }
+  /**
+   * Return direct dependents of a cell (cells whose formulas reference this cell).
+   * Returns an empty set if none.
+   */
+  getDependents(cell) {
+    return this.dependents.get(cell) ?? EMPTY_SET;
+  }
+  /**
+   * Return direct dependencies of a cell (cells referenced in this cell's formula).
+   * Returns an empty set if none.
+   */
+  getDependencies(cell) {
+    return this.dependencies.get(cell) ?? EMPTY_SET;
+  }
+  /**
+   * Clear both maps entirely.
+   */
+  clear() {
+    this.dependencies.clear();
+    this.dependents.clear();
+  }
+  // ---------------------------------------------------------------------------
+  // Private helpers
+  // ---------------------------------------------------------------------------
+  /**
+   * Remove `cell` from the forward dependencies map and clean up reverse
+   * references in the dependents map.
+   */
+  removeDependenciesInternal(cell) {
+    const oldDeps = this.dependencies.get(cell);
+    if (!oldDeps) {
+      return;
+    }
+    for (const oldDep of oldDeps) {
+      const depSet = this.dependents.get(oldDep);
+      if (depSet) {
+        depSet.delete(cell);
+        if (depSet.size === 0) {
+          this.dependents.delete(oldDep);
+        }
+      }
+    }
+    this.dependencies.delete(cell);
+  }
+  /**
+   * Iterative DFS: check if `target` is reachable from `start` by following
+   * the dependency chain. Iterative to avoid stack overflow for deep chains.
+   */
+  canReach(start, target, visited) {
+    if (start === target) return true;
+    if (visited.has(start)) return false;
+    const stack = [start];
+    visited.add(start);
+    while (stack.length > 0) {
+      const current = stack.pop();
+      const deps = this.dependencies.get(current);
+      if (!deps) continue;
+      for (const dep of deps) {
+        if (dep === target) return true;
+        if (!visited.has(dep)) {
+          visited.add(dep);
+          stack.push(dep);
+        }
+      }
+    }
+    return false;
+  }
+  /**
+   * Topological sort using Kahn's algorithm.
+   *
+   * 1. Collect all cells transitively dependent on the changed cell(s).
+   * 2. Build in-degree map for these cells (count how many of their
+   *    dependencies are in the affected set).
+   * 3. Start with cells whose in-degree is 0 (only depend on unaffected
+   *    cells or the changed cells themselves).
+   * 4. Process queue: for each cell, reduce in-degree of its dependents,
+   *    add to queue when in-degree reaches 0.
+   * 5. If any cells remain unprocessed, they're in a cycle — append them
+   *    at the end (engine marks as #CIRC!).
+   */
+  topologicalSort(changedCells) {
+    const affected = /* @__PURE__ */ new Set();
+    const bfsQueue = [];
+    for (const changed of changedCells) {
+      const directDependents = this.dependents.get(changed);
+      if (directDependents) {
+        for (const dep of directDependents) {
+          if (!affected.has(dep)) {
+            affected.add(dep);
+            bfsQueue.push(dep);
+          }
+        }
+      }
+    }
+    let head = 0;
+    while (head < bfsQueue.length) {
+      const current = bfsQueue[head++];
+      const currentDependents = this.dependents.get(current);
+      if (currentDependents) {
+        for (const dep of currentDependents) {
+          if (!affected.has(dep)) {
+            affected.add(dep);
+            bfsQueue.push(dep);
+          }
+        }
+      }
+    }
+    if (affected.size === 0) {
+      return [];
+    }
+    const inDegree = /* @__PURE__ */ new Map();
+    for (const cell of affected) {
+      let degree = 0;
+      const deps = this.dependencies.get(cell);
+      if (deps) {
+        for (const dep of deps) {
+          if (affected.has(dep)) {
+            degree++;
+          }
+        }
+      }
+      inDegree.set(cell, degree);
+    }
+    const queue = [];
+    for (const [cell, degree] of inDegree) {
+      if (degree === 0) {
+        queue.push(cell);
+      }
+    }
+    const result = [];
+    let queueHead = 0;
+    while (queueHead < queue.length) {
+      const cell = queue[queueHead++];
+      result.push(cell);
+      const cellDependents = this.dependents.get(cell);
+      if (cellDependents) {
+        for (const dependent of cellDependents) {
+          if (affected.has(dependent)) {
+            const newDegree = inDegree.get(dependent) - 1;
+            inDegree.set(dependent, newDegree);
+            if (newDegree === 0) {
+              queue.push(dependent);
+            }
+          }
+        }
+      }
+    }
+    if (result.length < affected.size) {
+      const resultSet = new Set(result);
+      for (const cell of affected) {
+        if (!resultSet.has(cell)) {
+          result.push(cell);
+        }
+      }
+    }
+    return result;
+  }
+};
+function registerMathFunctions(registry) {
+  registry.set("SUM", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      let sum = 0;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (typeof val === "number") {
+          sum += val;
+        } else if (typeof val === "boolean") {
+          sum += val ? 1 : 0;
+        }
+      }
+      return sum;
+    }
+  });
+  registry.set("AVERAGE", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      let sum = 0;
+      let count = 0;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (typeof val === "number") {
+          sum += val;
+          count++;
+        } else if (typeof val === "boolean") {
+          sum += val ? 1 : 0;
+          count++;
+        }
+      }
+      if (count === 0) return new FormulaError("#DIV/0!", "No numeric values for AVERAGE");
+      return sum / count;
+    }
+  });
+  registry.set("MIN", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      let min = Infinity;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (typeof val === "number") {
+          if (val < min) min = val;
+        } else if (typeof val === "boolean") {
+          const n = val ? 1 : 0;
+          if (n < min) min = n;
+        }
+      }
+      return min === Infinity ? 0 : min;
+    }
+  });
+  registry.set("MAX", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      let max = -Infinity;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (typeof val === "number") {
+          if (val > max) max = val;
+        } else if (typeof val === "boolean") {
+          const n = val ? 1 : 0;
+          if (n > max) max = n;
+        }
+      }
+      return max === -Infinity ? 0 : max;
+    }
+  });
+  registry.set("COUNT", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      let count = 0;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (typeof val === "number") {
+          count++;
+        }
+      }
+      return count;
+    }
+  });
+  registry.set("COUNTA", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      let count = 0;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (val !== null && val !== void 0 && val !== "") {
+          count++;
+        }
+      }
+      return count;
+    }
+  });
+  registry.set("ROUND", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawNum = evaluator.evaluate(args[0], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const num = toNumber(rawNum);
+      if (num instanceof FormulaError) return num;
+      const rawDigits = evaluator.evaluate(args[1], context);
+      if (rawDigits instanceof FormulaError) return rawDigits;
+      const digits = toNumber(rawDigits);
+      if (digits instanceof FormulaError) return digits;
+      const factor = Math.pow(10, Math.trunc(digits));
+      return Math.round(num * factor) / factor;
+    }
+  });
+  registry.set("ABS", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      return Math.abs(num);
+    }
+  });
+  registry.set("CEILING", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawNum = evaluator.evaluate(args[0], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const num = toNumber(rawNum);
+      if (num instanceof FormulaError) return num;
+      const rawSig = evaluator.evaluate(args[1], context);
+      if (rawSig instanceof FormulaError) return rawSig;
+      const significance = toNumber(rawSig);
+      if (significance instanceof FormulaError) return significance;
+      if (significance === 0) return 0;
+      return Math.ceil(num / significance) * significance;
+    }
+  });
+  registry.set("FLOOR", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawNum = evaluator.evaluate(args[0], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const num = toNumber(rawNum);
+      if (num instanceof FormulaError) return num;
+      const rawSig = evaluator.evaluate(args[1], context);
+      if (rawSig instanceof FormulaError) return rawSig;
+      const significance = toNumber(rawSig);
+      if (significance instanceof FormulaError) return significance;
+      if (significance === 0) return 0;
+      return Math.floor(num / significance) * significance;
+    }
+  });
+  registry.set("MOD", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawNum = evaluator.evaluate(args[0], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const num = toNumber(rawNum);
+      if (num instanceof FormulaError) return num;
+      const rawDiv = evaluator.evaluate(args[1], context);
+      if (rawDiv instanceof FormulaError) return rawDiv;
+      const divisor = toNumber(rawDiv);
+      if (divisor instanceof FormulaError) return divisor;
+      if (divisor === 0) return new FormulaError("#DIV/0!", "Division by zero in MOD");
+      return num % divisor;
+    }
+  });
+  registry.set("POWER", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawBase = evaluator.evaluate(args[0], context);
+      if (rawBase instanceof FormulaError) return rawBase;
+      const base = toNumber(rawBase);
+      if (base instanceof FormulaError) return base;
+      const rawExp = evaluator.evaluate(args[1], context);
+      if (rawExp instanceof FormulaError) return rawExp;
+      const exponent = toNumber(rawExp);
+      if (exponent instanceof FormulaError) return exponent;
+      return Math.pow(base, exponent);
+    }
+  });
+  registry.set("SQRT", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      if (num < 0) return new FormulaError("#VALUE!", "Cannot take square root of negative number");
+      return Math.sqrt(num);
+    }
+  });
+  registry.set("ROUNDUP", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawNum = evaluator.evaluate(args[0], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const num = toNumber(rawNum);
+      if (num instanceof FormulaError) return num;
+      const rawDigits = evaluator.evaluate(args[1], context);
+      if (rawDigits instanceof FormulaError) return rawDigits;
+      const digits = toNumber(rawDigits);
+      if (digits instanceof FormulaError) return digits;
+      const factor = Math.pow(10, Math.trunc(digits));
+      return num >= 0 ? Math.ceil(num * factor) / factor : Math.floor(num * factor) / factor;
+    }
+  });
+  registry.set("ROUNDDOWN", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawNum = evaluator.evaluate(args[0], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const num = toNumber(rawNum);
+      if (num instanceof FormulaError) return num;
+      const rawDigits = evaluator.evaluate(args[1], context);
+      if (rawDigits instanceof FormulaError) return rawDigits;
+      const digits = toNumber(rawDigits);
+      if (digits instanceof FormulaError) return digits;
+      const factor = Math.pow(10, Math.trunc(digits));
+      return Math.trunc(num * factor) / factor;
+    }
+  });
+  registry.set("INT", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      return Math.floor(num);
+    }
+  });
+  registry.set("TRUNC", {
+    minArgs: 1,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      let digits = 0;
+      if (args.length >= 2) {
+        const rawD = evaluator.evaluate(args[1], context);
+        if (rawD instanceof FormulaError) return rawD;
+        const d = toNumber(rawD);
+        if (d instanceof FormulaError) return d;
+        digits = Math.trunc(d);
+      }
+      const factor = Math.pow(10, digits);
+      return Math.trunc(num * factor) / factor;
+    }
+  });
+  registry.set("PRODUCT", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      let product = 1;
+      let hasNumber = false;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (typeof val === "number") {
+          product *= val;
+          hasNumber = true;
+        }
+      }
+      return hasNumber ? product : 0;
+    }
+  });
+  registry.set("SUMPRODUCT", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const arrays = [];
+      for (const arg of args) {
+        if (arg.kind !== "range") {
+          return new FormulaError("#VALUE!", "SUMPRODUCT arguments must be ranges");
+        }
+        arrays.push(context.getRangeValues({ start: arg.start, end: arg.end }));
+      }
+      if (arrays.length === 0) return 0;
+      const rows = arrays[0].length;
+      const cols = rows > 0 ? arrays[0][0].length : 0;
+      for (let a = 1; a < arrays.length; a++) {
+        if (arrays[a].length !== rows || rows > 0 && arrays[a][0].length !== cols) {
+          return new FormulaError("#VALUE!", "SUMPRODUCT arrays must have same dimensions");
+        }
+      }
+      let sum = 0;
+      for (let r = 0; r < rows; r++) {
+        for (let c = 0; c < cols; c++) {
+          let product = 1;
+          for (let a = 0; a < arrays.length; a++) {
+            const v = toNumber(arrays[a][r][c]);
+            if (v instanceof FormulaError) {
+              product = 0;
+              break;
+            }
+            product *= v;
+          }
+          sum += product;
+        }
+      }
+      return sum;
+    }
+  });
+  registry.set("MEDIAN", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      const nums = [];
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (typeof val === "number") nums.push(val);
+      }
+      if (nums.length === 0) return new FormulaError("#NUM!", "No numeric values for MEDIAN");
+      nums.sort((a, b) => a - b);
+      const mid = Math.floor(nums.length / 2);
+      return nums.length % 2 !== 0 ? nums[mid] : (nums[mid - 1] + nums[mid]) / 2;
+    }
+  });
+  registry.set("LARGE", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "LARGE first argument must be a range");
+      }
+      const rangeData = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const rawK = evaluator.evaluate(args[1], context);
+      if (rawK instanceof FormulaError) return rawK;
+      const k = toNumber(rawK);
+      if (k instanceof FormulaError) return k;
+      const nums = [];
+      for (const row of rangeData) {
+        for (const cell of row) {
+          if (typeof cell === "number") nums.push(cell);
+        }
+      }
+      const ki = Math.trunc(k);
+      if (ki < 1 || ki > nums.length) return new FormulaError("#NUM!", "LARGE k out of range");
+      nums.sort((a, b) => b - a);
+      return nums[ki - 1];
+    }
+  });
+  registry.set("SMALL", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "SMALL first argument must be a range");
+      }
+      const rangeData = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const rawK = evaluator.evaluate(args[1], context);
+      if (rawK instanceof FormulaError) return rawK;
+      const k = toNumber(rawK);
+      if (k instanceof FormulaError) return k;
+      const nums = [];
+      for (const row of rangeData) {
+        for (const cell of row) {
+          if (typeof cell === "number") nums.push(cell);
+        }
+      }
+      const ki = Math.trunc(k);
+      if (ki < 1 || ki > nums.length) return new FormulaError("#NUM!", "SMALL k out of range");
+      nums.sort((a, b) => a - b);
+      return nums[ki - 1];
+    }
+  });
+  registry.set("RANK", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const rawNum = evaluator.evaluate(args[0], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const num = toNumber(rawNum);
+      if (num instanceof FormulaError) return num;
+      if (args[1].kind !== "range") {
+        return new FormulaError("#VALUE!", "RANK second argument must be a range");
+      }
+      const rangeData = context.getRangeValues({ start: args[1].start, end: args[1].end });
+      let order = 0;
+      if (args.length >= 3) {
+        const rawO = evaluator.evaluate(args[2], context);
+        if (rawO instanceof FormulaError) return rawO;
+        const o = toNumber(rawO);
+        if (o instanceof FormulaError) return o;
+        order = o;
+      }
+      const nums = [];
+      for (const row of rangeData) {
+        for (const cell of row) {
+          if (typeof cell === "number") nums.push(cell);
+        }
+      }
+      if (!nums.includes(num)) return new FormulaError("#N/A", "RANK value not found in range");
+      let rank = 1;
+      for (const n of nums) {
+        if (order === 0 ? n > num : n < num) rank++;
+      }
+      return rank;
+    }
+  });
+  registry.set("SIGN", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      return num > 0 ? 1 : num < 0 ? -1 : 0;
+    }
+  });
+  registry.set("LOG", {
+    minArgs: 1,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      if (num <= 0) return new FormulaError("#NUM!", "LOG requires a positive number");
+      let base = 10;
+      if (args.length >= 2) {
+        const rawB = evaluator.evaluate(args[1], context);
+        if (rawB instanceof FormulaError) return rawB;
+        const b = toNumber(rawB);
+        if (b instanceof FormulaError) return b;
+        if (b <= 0 || b === 1) return new FormulaError("#NUM!", "LOG base must be positive and not 1");
+        base = b;
+      }
+      return Math.log(num) / Math.log(base);
+    }
+  });
+  registry.set("LN", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      if (num <= 0) return new FormulaError("#NUM!", "LN requires a positive number");
+      return Math.log(num);
+    }
+  });
+  registry.set("EXP", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      return Math.exp(num);
+    }
+  });
+  registry.set("PI", {
+    minArgs: 0,
+    maxArgs: 0,
+    evaluate() {
+      return Math.PI;
+    }
+  });
+  registry.set("RAND", {
+    minArgs: 0,
+    maxArgs: 0,
+    evaluate() {
+      return Math.random();
+    }
+  });
+  registry.set("RANDBETWEEN", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawLow = evaluator.evaluate(args[0], context);
+      if (rawLow instanceof FormulaError) return rawLow;
+      const low = toNumber(rawLow);
+      if (low instanceof FormulaError) return low;
+      const rawHigh = evaluator.evaluate(args[1], context);
+      if (rawHigh instanceof FormulaError) return rawHigh;
+      const high = toNumber(rawHigh);
+      if (high instanceof FormulaError) return high;
+      const lo = Math.ceil(low);
+      const hi = Math.floor(high);
+      if (lo > hi) return new FormulaError("#NUM!", "RANDBETWEEN bottom must be <= top");
+      return Math.floor(Math.random() * (hi - lo + 1)) + lo;
+    }
+  });
+}
+function flattenArgs2(args, context, evaluator) {
+  const result = [];
+  for (const arg of args) {
+    if (arg.kind === "range") {
+      const values = context.getRangeValues({ start: arg.start, end: arg.end });
+      for (const row of values) {
+        for (const cell of row) {
+          result.push(cell);
+        }
+      }
+    } else {
+      result.push(evaluator.evaluate(arg, context));
+    }
+  }
+  return result;
+}
+function registerLogicalFunctions(registry) {
+  registry.set("IF", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const condition = evaluator.evaluate(args[0], context);
+      if (condition instanceof FormulaError) return condition;
+      if (condition) {
+        return evaluator.evaluate(args[1], context);
+      } else {
+        if (args.length >= 3) {
+          return evaluator.evaluate(args[2], context);
+        }
+        return false;
+      }
+    }
+  });
+  registry.set("AND", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs2(args, context, evaluator);
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (!val) return false;
+      }
+      return true;
+    }
+  });
+  registry.set("OR", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs2(args, context, evaluator);
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (val) return true;
+      }
+      return false;
+    }
+  });
+  registry.set("NOT", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      return !val;
+    }
+  });
+  registry.set("IFERROR", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) {
+        return evaluator.evaluate(args[1], context);
+      }
+      return val;
+    }
+  });
+  registry.set("IFNA", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError && val.type === "#N/A") {
+        return evaluator.evaluate(args[1], context);
+      }
+      return val;
+    }
+  });
+  registry.set("IFS", {
+    minArgs: 2,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      if (args.length % 2 !== 0) {
+        return new FormulaError("#VALUE!", "IFS requires pairs of condition, value");
+      }
+      for (let i = 0; i < args.length; i += 2) {
+        const condition = evaluator.evaluate(args[i], context);
+        if (condition instanceof FormulaError) return condition;
+        if (condition) {
+          return evaluator.evaluate(args[i + 1], context);
+        }
+      }
+      return new FormulaError("#N/A", "IFS no condition was TRUE");
+    }
+  });
+  registry.set("SWITCH", {
+    minArgs: 3,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const expr = evaluator.evaluate(args[0], context);
+      if (expr instanceof FormulaError) return expr;
+      const hasDefault = (args.length - 1) % 2 !== 0;
+      const pairCount = hasDefault ? (args.length - 2) / 2 : (args.length - 1) / 2;
+      for (let i = 0; i < pairCount; i++) {
+        const caseVal = evaluator.evaluate(args[1 + i * 2], context);
+        if (caseVal instanceof FormulaError) return caseVal;
+        if (expr === caseVal) {
+          return evaluator.evaluate(args[2 + i * 2], context);
+        }
+      }
+      if (hasDefault) {
+        return evaluator.evaluate(args[args.length - 1], context);
+      }
+      return new FormulaError("#N/A", "SWITCH no match found");
+    }
+  });
+  registry.set("CHOOSE", {
+    minArgs: 2,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const rawIdx = evaluator.evaluate(args[0], context);
+      if (rawIdx instanceof FormulaError) return rawIdx;
+      if (typeof rawIdx !== "number") return new FormulaError("#VALUE!", "CHOOSE index must be a number");
+      const idx = Math.trunc(rawIdx);
+      if (idx < 1 || idx >= args.length) {
+        return new FormulaError("#VALUE!", "CHOOSE index out of range");
+      }
+      return evaluator.evaluate(args[idx], context);
+    }
+  });
+  registry.set("XOR", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs2(args, context, evaluator);
+      let trueCount = 0;
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        if (val) trueCount++;
+      }
+      return trueCount % 2 === 1;
+    }
+  });
+}
+function registerLookupFunctions(registry) {
+  registry.set("VLOOKUP", {
+    minArgs: 3,
+    maxArgs: 4,
+    evaluate(args, context, evaluator) {
+      const lookupValue = evaluator.evaluate(args[0], context);
+      if (lookupValue instanceof FormulaError) return lookupValue;
+      if (args[1].kind !== "range") {
+        return new FormulaError("#VALUE!", "VLOOKUP table_array must be a range");
+      }
+      const tableData = context.getRangeValues({ start: args[1].start, end: args[1].end });
+      const rawColIndex = evaluator.evaluate(args[2], context);
+      if (rawColIndex instanceof FormulaError) return rawColIndex;
+      const colIndex = toNumber(rawColIndex);
+      if (colIndex instanceof FormulaError) return colIndex;
+      if (colIndex < 1) return new FormulaError("#VALUE!", "VLOOKUP col_index must be >= 1");
+      if (tableData.length > 0 && colIndex > tableData[0].length) {
+        return new FormulaError("#REF!", "VLOOKUP col_index exceeds table columns");
+      }
+      let rangeLookup = true;
+      if (args.length >= 4) {
+        const rawRL = evaluator.evaluate(args[3], context);
+        if (rawRL instanceof FormulaError) return rawRL;
+        rangeLookup = !!rawRL;
+      }
+      const col = Math.trunc(colIndex) - 1;
+      const lookupLower = typeof lookupValue === "string" ? lookupValue.toLowerCase() : null;
+      if (rangeLookup) {
+        let bestRow = -1;
+        for (let r = 0; r < tableData.length; r++) {
+          const cellVal = tableData[r][0];
+          if (cellVal === null || cellVal === void 0) continue;
+          if (typeof lookupValue === "number" && typeof cellVal === "number") {
+            if (cellVal <= lookupValue) bestRow = r;
+            else break;
+          } else if (lookupLower !== null && typeof cellVal === "string") {
+            if (cellVal.toLowerCase() <= lookupLower) bestRow = r;
+            else break;
+          }
+        }
+        if (bestRow === -1) return new FormulaError("#N/A", "VLOOKUP no match found");
+        return tableData[bestRow][col] ?? null;
+      } else {
+        for (let r = 0; r < tableData.length; r++) {
+          const cellVal = tableData[r][0];
+          if (lookupLower !== null && typeof cellVal === "string") {
+            if (cellVal.toLowerCase() === lookupLower) {
+              return tableData[r][col] ?? null;
+            }
+          } else if (cellVal === lookupValue) {
+            return tableData[r][col] ?? null;
+          }
+        }
+        return new FormulaError("#N/A", "VLOOKUP no exact match found");
+      }
+    }
+  });
+  registry.set("INDEX", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "INDEX first argument must be a range");
+      }
+      const rangeData = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const rawRow = evaluator.evaluate(args[1], context);
+      if (rawRow instanceof FormulaError) return rawRow;
+      const rowNum = toNumber(rawRow);
+      if (rowNum instanceof FormulaError) return rowNum;
+      let colNum = 1;
+      if (args.length >= 3) {
+        const rawCol = evaluator.evaluate(args[2], context);
+        if (rawCol instanceof FormulaError) return rawCol;
+        const c2 = toNumber(rawCol);
+        if (c2 instanceof FormulaError) return c2;
+        colNum = c2;
+      }
+      const r = Math.trunc(rowNum) - 1;
+      const c = Math.trunc(colNum) - 1;
+      if (r < 0 || r >= rangeData.length) {
+        return new FormulaError("#REF!", "INDEX row out of bounds");
+      }
+      if (c < 0 || rangeData.length > 0 && c >= rangeData[0].length) {
+        return new FormulaError("#REF!", "INDEX column out of bounds");
+      }
+      return rangeData[r][c] ?? null;
+    }
+  });
+  registry.set("HLOOKUP", {
+    minArgs: 3,
+    maxArgs: 4,
+    evaluate(args, context, evaluator) {
+      const lookupValue = evaluator.evaluate(args[0], context);
+      if (lookupValue instanceof FormulaError) return lookupValue;
+      if (args[1].kind !== "range") {
+        return new FormulaError("#VALUE!", "HLOOKUP table_array must be a range");
+      }
+      const tableData = context.getRangeValues({ start: args[1].start, end: args[1].end });
+      const rawRowIndex = evaluator.evaluate(args[2], context);
+      if (rawRowIndex instanceof FormulaError) return rawRowIndex;
+      const rowIndex = toNumber(rawRowIndex);
+      if (rowIndex instanceof FormulaError) return rowIndex;
+      if (rowIndex < 1) return new FormulaError("#VALUE!", "HLOOKUP row_index must be >= 1");
+      if (rowIndex > tableData.length) {
+        return new FormulaError("#REF!", "HLOOKUP row_index exceeds table rows");
+      }
+      let rangeLookup = true;
+      if (args.length >= 4) {
+        const rawRL = evaluator.evaluate(args[3], context);
+        if (rawRL instanceof FormulaError) return rawRL;
+        rangeLookup = !!rawRL;
+      }
+      const row = Math.trunc(rowIndex) - 1;
+      const firstRow = tableData[0] || [];
+      const lookupLower = typeof lookupValue === "string" ? lookupValue.toLowerCase() : null;
+      if (rangeLookup) {
+        let bestCol = -1;
+        for (let c = 0; c < firstRow.length; c++) {
+          const cellVal = firstRow[c];
+          if (cellVal === null || cellVal === void 0) continue;
+          if (typeof lookupValue === "number" && typeof cellVal === "number") {
+            if (cellVal <= lookupValue) bestCol = c;
+            else break;
+          } else if (lookupLower !== null && typeof cellVal === "string") {
+            if (cellVal.toLowerCase() <= lookupLower) bestCol = c;
+            else break;
+          }
+        }
+        if (bestCol === -1) return new FormulaError("#N/A", "HLOOKUP no match found");
+        return tableData[row][bestCol] ?? null;
+      } else {
+        for (let c = 0; c < firstRow.length; c++) {
+          const cellVal = firstRow[c];
+          if (lookupLower !== null && typeof cellVal === "string") {
+            if (cellVal.toLowerCase() === lookupLower) return tableData[row][c] ?? null;
+          } else if (cellVal === lookupValue) {
+            return tableData[row][c] ?? null;
+          }
+        }
+        return new FormulaError("#N/A", "HLOOKUP no exact match found");
+      }
+    }
+  });
+  registry.set("XLOOKUP", {
+    minArgs: 3,
+    maxArgs: 6,
+    evaluate(args, context, evaluator) {
+      const lookupValue = evaluator.evaluate(args[0], context);
+      if (lookupValue instanceof FormulaError) return lookupValue;
+      if (args[1].kind !== "range") {
+        return new FormulaError("#VALUE!", "XLOOKUP lookup_array must be a range");
+      }
+      const lookupArray = context.getRangeValues({ start: args[1].start, end: args[1].end });
+      if (args[2].kind !== "range") {
+        return new FormulaError("#VALUE!", "XLOOKUP return_array must be a range");
+      }
+      const returnArray = context.getRangeValues({ start: args[2].start, end: args[2].end });
+      let ifNotFound = new FormulaError("#N/A", "XLOOKUP no match found");
+      if (args.length >= 4) {
+        ifNotFound = evaluator.evaluate(args[3], context);
+      }
+      let matchMode = 0;
+      if (args.length >= 5) {
+        const rawMM = evaluator.evaluate(args[4], context);
+        if (rawMM instanceof FormulaError) return rawMM;
+        const mm = toNumber(rawMM);
+        if (mm instanceof FormulaError) return mm;
+        matchMode = Math.trunc(mm);
+      }
+      let searchMode = 1;
+      if (args.length >= 6) {
+        const rawSM = evaluator.evaluate(args[5], context);
+        if (rawSM instanceof FormulaError) return rawSM;
+        const sm = toNumber(rawSM);
+        if (sm instanceof FormulaError) return sm;
+        searchMode = Math.trunc(sm);
+      }
+      const isRow = lookupArray.length === 1;
+      const len = isRow ? lookupArray[0].length : lookupArray.length;
+      const getVal = isRow ? (i) => lookupArray[0][i] : (i) => lookupArray[i][0];
+      const lookupLower = typeof lookupValue === "string" ? lookupValue.toLowerCase() : null;
+      const eq = (a, b) => {
+        if (lookupLower !== null && typeof a === "string") return a.toLowerCase() === lookupLower;
+        return a === b;
+      };
+      let foundIdx = -1;
+      if (matchMode === 0) {
+        const start = searchMode >= 0 ? 0 : len - 1;
+        const end = searchMode >= 0 ? len : -1;
+        const step = searchMode >= 0 ? 1 : -1;
+        for (let i = start; i !== end; i += step) {
+          if (eq(getVal(i), lookupValue)) {
+            foundIdx = i;
+            break;
+          }
+        }
+      } else if (matchMode === -1) {
+        let best = -1;
+        for (let i = 0; i < len; i++) {
+          const v = getVal(i);
+          if (eq(v, lookupValue)) {
+            foundIdx = i;
+            break;
+          }
+          if (typeof lookupValue === "number" && typeof v === "number" && v < lookupValue) {
+            if (best === -1 || v > getVal(best)) best = i;
+          }
+        }
+        if (foundIdx === -1) foundIdx = best;
+      } else if (matchMode === 1) {
+        let best = -1;
+        for (let i = 0; i < len; i++) {
+          const v = getVal(i);
+          if (eq(v, lookupValue)) {
+            foundIdx = i;
+            break;
+          }
+          if (typeof lookupValue === "number" && typeof v === "number" && v > lookupValue) {
+            if (best === -1 || v < getVal(best)) best = i;
+          }
+        }
+        if (foundIdx === -1) foundIdx = best;
+      }
+      if (foundIdx === -1) return ifNotFound;
+      const isReturnRow = returnArray.length === 1;
+      if (isReturnRow) return returnArray[0][foundIdx] ?? null;
+      return returnArray[foundIdx]?.[0] ?? null;
+    }
+  });
+  registry.set("MATCH", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const lookupValue = evaluator.evaluate(args[0], context);
+      if (lookupValue instanceof FormulaError) return lookupValue;
+      if (args[1].kind !== "range") {
+        return new FormulaError("#VALUE!", "MATCH lookup_array must be a range");
+      }
+      const rangeData = context.getRangeValues({ start: args[1].start, end: args[1].end });
+      const isSingleRow = rangeData.length === 1;
+      const values = isSingleRow ? rangeData[0] : rangeData;
+      const getValue = isSingleRow ? (i) => values[i] : (i) => values[i][0];
+      const valuesLength = isSingleRow ? values.length : values.length;
+      let matchType = 1;
+      if (args.length >= 3) {
+        const rawMT = evaluator.evaluate(args[2], context);
+        if (rawMT instanceof FormulaError) return rawMT;
+        const mt = toNumber(rawMT);
+        if (mt instanceof FormulaError) return mt;
+        matchType = mt;
+      }
+      const lookupLower = typeof lookupValue === "string" ? lookupValue.toLowerCase() : null;
+      if (matchType === 0) {
+        for (let i = 0; i < valuesLength; i++) {
+          const cellVal = getValue(i);
+          if (lookupLower !== null && typeof cellVal === "string") {
+            if (cellVal.toLowerCase() === lookupLower) return i + 1;
+          } else if (cellVal === lookupValue) {
+            return i + 1;
+          }
+        }
+        return new FormulaError("#N/A", "MATCH no exact match found");
+      } else if (matchType === 1) {
+        let bestIndex = -1;
+        for (let i = 0; i < valuesLength; i++) {
+          const cellVal = getValue(i);
+          if (cellVal === null || cellVal === void 0) continue;
+          if (typeof lookupValue === "number" && typeof cellVal === "number") {
+            if (cellVal <= lookupValue) bestIndex = i;
+            else break;
+          } else if (lookupLower !== null && typeof cellVal === "string") {
+            if (cellVal.toLowerCase() <= lookupLower) bestIndex = i;
+            else break;
+          }
+        }
+        if (bestIndex === -1) return new FormulaError("#N/A", "MATCH no match found");
+        return bestIndex + 1;
+      } else {
+        let bestIndex = -1;
+        for (let i = 0; i < valuesLength; i++) {
+          const cellVal = getValue(i);
+          if (cellVal === null || cellVal === void 0) continue;
+          if (typeof lookupValue === "number" && typeof cellVal === "number") {
+            if (cellVal >= lookupValue) bestIndex = i;
+            else break;
+          } else if (lookupLower !== null && typeof cellVal === "string") {
+            if (cellVal.toLowerCase() >= lookupLower) bestIndex = i;
+            else break;
+          }
+        }
+        if (bestIndex === -1) return new FormulaError("#N/A", "MATCH no match found");
+        return bestIndex + 1;
+      }
+    }
+  });
+}
+function registerTextFunctions(registry) {
+  registry.set("CONCATENATE", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      const parts = [];
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        parts.push(toString(val));
+      }
+      return parts.join("");
+    }
+  });
+  registry.set("CONCAT", {
+    minArgs: 1,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const values = flattenArgs(args, context, evaluator);
+      const parts = [];
+      for (const val of values) {
+        if (val instanceof FormulaError) return val;
+        parts.push(toString(val));
+      }
+      return parts.join("");
+    }
+  });
+  registry.set("UPPER", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      return toString(val).toUpperCase();
+    }
+  });
+  registry.set("LOWER", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      return toString(val).toLowerCase();
+    }
+  });
+  registry.set("TRIM", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      return toString(val).trim();
+    }
+  });
+  registry.set("LEFT", {
+    minArgs: 1,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const text = toString(val);
+      let numChars = 1;
+      if (args.length >= 2) {
+        const rawNum = evaluator.evaluate(args[1], context);
+        if (rawNum instanceof FormulaError) return rawNum;
+        const n = toNumber(rawNum);
+        if (n instanceof FormulaError) return n;
+        numChars = Math.trunc(n);
+      }
+      if (numChars < 0) return new FormulaError("#VALUE!", "LEFT num_chars must be >= 0");
+      return text.substring(0, numChars);
+    }
+  });
+  registry.set("RIGHT", {
+    minArgs: 1,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const text = toString(val);
+      let numChars = 1;
+      if (args.length >= 2) {
+        const rawNum = evaluator.evaluate(args[1], context);
+        if (rawNum instanceof FormulaError) return rawNum;
+        const n = toNumber(rawNum);
+        if (n instanceof FormulaError) return n;
+        numChars = Math.trunc(n);
+      }
+      if (numChars < 0) return new FormulaError("#VALUE!", "RIGHT num_chars must be >= 0");
+      return text.substring(Math.max(0, text.length - numChars));
+    }
+  });
+  registry.set("MID", {
+    minArgs: 3,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const text = toString(val);
+      const rawStart = evaluator.evaluate(args[1], context);
+      if (rawStart instanceof FormulaError) return rawStart;
+      const startPos = toNumber(rawStart);
+      if (startPos instanceof FormulaError) return startPos;
+      const rawNum = evaluator.evaluate(args[2], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const numChars = toNumber(rawNum);
+      if (numChars instanceof FormulaError) return numChars;
+      const start = Math.trunc(startPos);
+      const count = Math.trunc(numChars);
+      if (start < 1) return new FormulaError("#VALUE!", "MID start_num must be >= 1");
+      if (count < 0) return new FormulaError("#VALUE!", "MID num_chars must be >= 0");
+      return text.substring(start - 1, start - 1 + count);
+    }
+  });
+  registry.set("LEN", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      return toString(val).length;
+    }
+  });
+  registry.set("SUBSTITUTE", {
+    minArgs: 3,
+    maxArgs: 4,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const text = toString(val);
+      const rawOld = evaluator.evaluate(args[1], context);
+      if (rawOld instanceof FormulaError) return rawOld;
+      const oldText = toString(rawOld);
+      const rawNew = evaluator.evaluate(args[2], context);
+      if (rawNew instanceof FormulaError) return rawNew;
+      const newText = toString(rawNew);
+      if (args.length >= 4) {
+        const rawInstance = evaluator.evaluate(args[3], context);
+        if (rawInstance instanceof FormulaError) return rawInstance;
+        const instanceNum = toNumber(rawInstance);
+        if (instanceNum instanceof FormulaError) return instanceNum;
+        const n = Math.trunc(instanceNum);
+        if (n < 1) return new FormulaError("#VALUE!", "SUBSTITUTE instance_num must be >= 1");
+        let count = 0;
+        let result = "";
+        let searchFrom = 0;
+        while (searchFrom <= text.length) {
+          const idx = text.indexOf(oldText, searchFrom);
+          if (idx === -1) {
+            result += text.substring(searchFrom);
+            break;
+          }
+          count++;
+          if (count === n) {
+            result += text.substring(searchFrom, idx) + newText;
+            result += text.substring(idx + oldText.length);
+            break;
+          } else {
+            result += text.substring(searchFrom, idx + oldText.length);
+            searchFrom = idx + oldText.length;
+          }
+        }
+        return result;
+      } else {
+        if (oldText === "") return text;
+        return text.split(oldText).join(newText);
+      }
+    }
+  });
+  registry.set("FIND", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const rawFind = evaluator.evaluate(args[0], context);
+      if (rawFind instanceof FormulaError) return rawFind;
+      const findText = toString(rawFind);
+      const rawWithin = evaluator.evaluate(args[1], context);
+      if (rawWithin instanceof FormulaError) return rawWithin;
+      const withinText = toString(rawWithin);
+      let startNum = 1;
+      if (args.length >= 3) {
+        const rawStart = evaluator.evaluate(args[2], context);
+        if (rawStart instanceof FormulaError) return rawStart;
+        const s = toNumber(rawStart);
+        if (s instanceof FormulaError) return s;
+        startNum = Math.trunc(s);
+      }
+      if (startNum < 1) return new FormulaError("#VALUE!", "FIND start_num must be >= 1");
+      const idx = withinText.indexOf(findText, startNum - 1);
+      if (idx === -1) return new FormulaError("#VALUE!", "FIND text not found");
+      return idx + 1;
+    }
+  });
+  registry.set("SEARCH", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const rawFind = evaluator.evaluate(args[0], context);
+      if (rawFind instanceof FormulaError) return rawFind;
+      const findText = toString(rawFind).toLowerCase();
+      const rawWithin = evaluator.evaluate(args[1], context);
+      if (rawWithin instanceof FormulaError) return rawWithin;
+      const withinText = toString(rawWithin).toLowerCase();
+      let startNum = 1;
+      if (args.length >= 3) {
+        const rawStart = evaluator.evaluate(args[2], context);
+        if (rawStart instanceof FormulaError) return rawStart;
+        const s = toNumber(rawStart);
+        if (s instanceof FormulaError) return s;
+        startNum = Math.trunc(s);
+      }
+      if (startNum < 1) return new FormulaError("#VALUE!", "SEARCH start_num must be >= 1");
+      const idx = withinText.indexOf(findText, startNum - 1);
+      if (idx === -1) return new FormulaError("#VALUE!", "SEARCH text not found");
+      return idx + 1;
+    }
+  });
+  registry.set("REPLACE", {
+    minArgs: 4,
+    maxArgs: 4,
+    evaluate(args, context, evaluator) {
+      const rawText = evaluator.evaluate(args[0], context);
+      if (rawText instanceof FormulaError) return rawText;
+      const text = toString(rawText);
+      const rawStart = evaluator.evaluate(args[1], context);
+      if (rawStart instanceof FormulaError) return rawStart;
+      const startPos = toNumber(rawStart);
+      if (startPos instanceof FormulaError) return startPos;
+      const rawNum = evaluator.evaluate(args[2], context);
+      if (rawNum instanceof FormulaError) return rawNum;
+      const numChars = toNumber(rawNum);
+      if (numChars instanceof FormulaError) return numChars;
+      const rawNew = evaluator.evaluate(args[3], context);
+      if (rawNew instanceof FormulaError) return rawNew;
+      const newText = toString(rawNew);
+      const start = Math.trunc(startPos) - 1;
+      const count = Math.trunc(numChars);
+      return text.substring(0, start) + newText + text.substring(start + count);
+    }
+  });
+  registry.set("REPT", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawText = evaluator.evaluate(args[0], context);
+      if (rawText instanceof FormulaError) return rawText;
+      const text = toString(rawText);
+      const rawTimes = evaluator.evaluate(args[1], context);
+      if (rawTimes instanceof FormulaError) return rawTimes;
+      const times = toNumber(rawTimes);
+      if (times instanceof FormulaError) return times;
+      const n = Math.trunc(times);
+      if (n < 0) return new FormulaError("#VALUE!", "REPT number must be >= 0");
+      return text.repeat(n);
+    }
+  });
+  registry.set("EXACT", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawA = evaluator.evaluate(args[0], context);
+      if (rawA instanceof FormulaError) return rawA;
+      const rawB = evaluator.evaluate(args[1], context);
+      if (rawB instanceof FormulaError) return rawB;
+      return toString(rawA) === toString(rawB);
+    }
+  });
+  registry.set("PROPER", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      return toString(val).toLowerCase().replace(/\b\w/g, (c) => c.toUpperCase());
+    }
+  });
+  registry.set("CLEAN", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      return toString(val).replace(/[\x00-\x1F]/g, "");
+    }
+  });
+  registry.set("CHAR", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return num;
+      const n = Math.trunc(num);
+      if (n < 1 || n > 65535) return new FormulaError("#VALUE!", "CHAR number must be 1-65535");
+      return String.fromCharCode(n);
+    }
+  });
+  registry.set("CODE", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const text = toString(val);
+      if (text.length === 0) return new FormulaError("#VALUE!", "CODE requires non-empty text");
+      return text.charCodeAt(0);
+    }
+  });
+  registry.set("TEXT", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawVal = evaluator.evaluate(args[0], context);
+      if (rawVal instanceof FormulaError) return rawVal;
+      const rawFmt = evaluator.evaluate(args[1], context);
+      if (rawFmt instanceof FormulaError) return rawFmt;
+      const fmt = toString(rawFmt);
+      const num = toNumber(rawVal);
+      if (num instanceof FormulaError) return toString(rawVal);
+      if (fmt.includes("%")) {
+        const decimals2 = (fmt.match(/0/g) || []).length - 1;
+        return (num * 100).toFixed(Math.max(0, decimals2)) + "%";
+      }
+      const decimalMatch = fmt.match(/\.(0+)/);
+      const decimals = decimalMatch ? decimalMatch[1].length : 0;
+      const useCommas = fmt.includes(",");
+      const result = num.toFixed(decimals);
+      if (useCommas) {
+        const [intPart, decPart] = result.split(".");
+        const withCommas = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+        return decPart ? withCommas + "." + decPart : withCommas;
+      }
+      return result;
+    }
+  });
+  registry.set("VALUE", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      if (typeof val === "number") return val;
+      const raw = toString(val).trim();
+      const isPercent = raw.endsWith("%");
+      const text = raw.replace(/[,$%\s]/g, "");
+      const n = Number(text);
+      if (isNaN(n)) return new FormulaError("#VALUE!", "VALUE cannot convert text to number");
+      return isPercent ? n / 100 : n;
+    }
+  });
+  registry.set("TEXTJOIN", {
+    minArgs: 3,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      const rawDelim = evaluator.evaluate(args[0], context);
+      if (rawDelim instanceof FormulaError) return rawDelim;
+      const delimiter = toString(rawDelim);
+      const rawIgnore = evaluator.evaluate(args[1], context);
+      if (rawIgnore instanceof FormulaError) return rawIgnore;
+      const ignoreEmpty = !!rawIgnore;
+      const parts = [];
+      for (let i = 2; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.kind === "range") {
+          const rangeData = context.getRangeValues({ start: arg.start, end: arg.end });
+          for (const row of rangeData) {
+            for (const cell of row) {
+              if (cell instanceof FormulaError) return cell;
+              const s = toString(cell);
+              if (!ignoreEmpty || s !== "") parts.push(s);
+            }
+          }
+        } else {
+          const val = evaluator.evaluate(args[i], context);
+          if (val instanceof FormulaError) return val;
+          const s = toString(val);
+          if (!ignoreEmpty || s !== "") parts.push(s);
+        }
+      }
+      return parts.join(delimiter);
+    }
+  });
+}
+function toDate(val) {
+  if (val instanceof FormulaError) return val;
+  if (val instanceof Date) {
+    if (isNaN(val.getTime())) return new FormulaError("#VALUE!", "Invalid date");
+    return val;
+  }
+  if (typeof val === "string") {
+    const d = new Date(val);
+    if (isNaN(d.getTime())) return new FormulaError("#VALUE!", `Cannot parse "${val}" as date`);
+    return d;
+  }
+  if (typeof val === "number") {
+    const d = new Date(val);
+    if (isNaN(d.getTime())) return new FormulaError("#VALUE!", "Invalid numeric date");
+    return d;
+  }
+  return new FormulaError("#VALUE!", "Cannot convert value to date");
+}
+function registerDateFunctions(registry) {
+  registry.set("TODAY", {
+    minArgs: 0,
+    maxArgs: 0,
+    evaluate(_args, context) {
+      const now = context.now();
+      return new Date(now.getFullYear(), now.getMonth(), now.getDate());
+    }
+  });
+  registry.set("NOW", {
+    minArgs: 0,
+    maxArgs: 0,
+    evaluate(_args, context) {
+      return context.now();
+    }
+  });
+  registry.set("YEAR", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const date = toDate(val);
+      if (date instanceof FormulaError) return date;
+      return date.getFullYear();
+    }
+  });
+  registry.set("MONTH", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const date = toDate(val);
+      if (date instanceof FormulaError) return date;
+      return date.getMonth() + 1;
+    }
+  });
+  registry.set("DAY", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const date = toDate(val);
+      if (date instanceof FormulaError) return date;
+      return date.getDate();
+    }
+  });
+  registry.set("DATE", {
+    minArgs: 3,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const rawY = evaluator.evaluate(args[0], context);
+      if (rawY instanceof FormulaError) return rawY;
+      const y = toNumber(rawY);
+      if (y instanceof FormulaError) return y;
+      const rawM = evaluator.evaluate(args[1], context);
+      if (rawM instanceof FormulaError) return rawM;
+      const m = toNumber(rawM);
+      if (m instanceof FormulaError) return m;
+      const rawD = evaluator.evaluate(args[2], context);
+      if (rawD instanceof FormulaError) return rawD;
+      const d = toNumber(rawD);
+      if (d instanceof FormulaError) return d;
+      return new Date(Math.trunc(y), Math.trunc(m) - 1, Math.trunc(d));
+    }
+  });
+  registry.set("DATEDIF", {
+    minArgs: 3,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      const rawStart = evaluator.evaluate(args[0], context);
+      if (rawStart instanceof FormulaError) return rawStart;
+      const startDate = toDate(rawStart);
+      if (startDate instanceof FormulaError) return startDate;
+      const rawEnd = evaluator.evaluate(args[1], context);
+      if (rawEnd instanceof FormulaError) return rawEnd;
+      const endDate = toDate(rawEnd);
+      if (endDate instanceof FormulaError) return endDate;
+      const rawUnit = evaluator.evaluate(args[2], context);
+      if (rawUnit instanceof FormulaError) return rawUnit;
+      const unit = String(rawUnit).toUpperCase();
+      if (startDate > endDate) return new FormulaError("#NUM!", "DATEDIF start date must be <= end date");
+      switch (unit) {
+        case "Y": {
+          let years = endDate.getFullYear() - startDate.getFullYear();
+          if (endDate.getMonth() < startDate.getMonth() || endDate.getMonth() === startDate.getMonth() && endDate.getDate() < startDate.getDate()) {
+            years--;
+          }
+          return years;
+        }
+        case "M": {
+          let months = (endDate.getFullYear() - startDate.getFullYear()) * 12 + endDate.getMonth() - startDate.getMonth();
+          if (endDate.getDate() < startDate.getDate()) months--;
+          return months;
+        }
+        case "D":
+          return Math.floor((endDate.getTime() - startDate.getTime()) / 864e5);
+        default:
+          return new FormulaError("#VALUE!", "DATEDIF unit must be Y, M, or D");
+      }
+    }
+  });
+  registry.set("EDATE", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawDate = evaluator.evaluate(args[0], context);
+      if (rawDate instanceof FormulaError) return rawDate;
+      const date = toDate(rawDate);
+      if (date instanceof FormulaError) return date;
+      const rawMonths = evaluator.evaluate(args[1], context);
+      if (rawMonths instanceof FormulaError) return rawMonths;
+      const months = toNumber(rawMonths);
+      if (months instanceof FormulaError) return months;
+      const result = new Date(date);
+      result.setMonth(result.getMonth() + Math.trunc(months));
+      return result;
+    }
+  });
+  registry.set("EOMONTH", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawDate = evaluator.evaluate(args[0], context);
+      if (rawDate instanceof FormulaError) return rawDate;
+      const date = toDate(rawDate);
+      if (date instanceof FormulaError) return date;
+      const rawMonths = evaluator.evaluate(args[1], context);
+      if (rawMonths instanceof FormulaError) return rawMonths;
+      const months = toNumber(rawMonths);
+      if (months instanceof FormulaError) return months;
+      const result = new Date(date.getFullYear(), date.getMonth() + Math.trunc(months) + 1, 0);
+      return result;
+    }
+  });
+  registry.set("WEEKDAY", {
+    minArgs: 1,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawDate = evaluator.evaluate(args[0], context);
+      if (rawDate instanceof FormulaError) return rawDate;
+      const date = toDate(rawDate);
+      if (date instanceof FormulaError) return date;
+      let returnType = 1;
+      if (args.length >= 2) {
+        const rawRT = evaluator.evaluate(args[1], context);
+        if (rawRT instanceof FormulaError) return rawRT;
+        const rt = toNumber(rawRT);
+        if (rt instanceof FormulaError) return rt;
+        returnType = Math.trunc(rt);
+      }
+      const day = date.getDay();
+      switch (returnType) {
+        case 1:
+          return day + 1;
+        // 1=Sun, 7=Sat
+        case 2:
+          return day === 0 ? 7 : day;
+        // 1=Mon, 7=Sun
+        case 3:
+          return day === 0 ? 6 : day - 1;
+        // 0=Mon, 6=Sun
+        default:
+          return new FormulaError("#VALUE!", "WEEKDAY return_type must be 1, 2, or 3");
+      }
+    }
+  });
+  registry.set("HOUR", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const date = toDate(val);
+      if (date instanceof FormulaError) return date;
+      return date.getHours();
+    }
+  });
+  registry.set("MINUTE", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const date = toDate(val);
+      if (date instanceof FormulaError) return date;
+      return date.getMinutes();
+    }
+  });
+  registry.set("SECOND", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return val;
+      const date = toDate(val);
+      if (date instanceof FormulaError) return date;
+      return date.getSeconds();
+    }
+  });
+  registry.set("NETWORKDAYS", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      const rawStart = evaluator.evaluate(args[0], context);
+      if (rawStart instanceof FormulaError) return rawStart;
+      const startDate = toDate(rawStart);
+      if (startDate instanceof FormulaError) return startDate;
+      const rawEnd = evaluator.evaluate(args[1], context);
+      if (rawEnd instanceof FormulaError) return rawEnd;
+      const endDate = toDate(rawEnd);
+      if (endDate instanceof FormulaError) return endDate;
+      const start = new Date(startDate.getFullYear(), startDate.getMonth(), startDate.getDate());
+      const end = new Date(endDate.getFullYear(), endDate.getMonth(), endDate.getDate());
+      const sign = end >= start ? 1 : -1;
+      const [from, to] = sign === 1 ? [start, end] : [end, start];
+      let count = 0;
+      const current = new Date(from);
+      while (current <= to) {
+        const day = current.getDay();
+        if (day !== 0 && day !== 6) count++;
+        current.setDate(current.getDate() + 1);
+      }
+      return count * sign;
+    }
+  });
+}
+function makeCriteria(op, value) {
+  return { op, value, valueLower: typeof value === "string" ? value.toLowerCase() : null };
+}
+function parseCriteria(criteria) {
+  if (typeof criteria === "number") {
+    return makeCriteria("=", criteria);
+  }
+  if (typeof criteria !== "string") {
+    return makeCriteria("=", criteria);
+  }
+  const str = criteria.trim();
+  if (str.startsWith(">=")) {
+    return makeCriteria(">=", parseNumericOrString(str.substring(2).trim()));
+  }
+  if (str.startsWith("<=")) {
+    return makeCriteria("<=", parseNumericOrString(str.substring(2).trim()));
+  }
+  if (str.startsWith("<>")) {
+    return makeCriteria("<>", parseNumericOrString(str.substring(2).trim()));
+  }
+  if (str.startsWith(">")) {
+    return makeCriteria(">", parseNumericOrString(str.substring(1).trim()));
+  }
+  if (str.startsWith("<")) {
+    return makeCriteria("<", parseNumericOrString(str.substring(1).trim()));
+  }
+  if (str.startsWith("=")) {
+    return makeCriteria("=", parseNumericOrString(str.substring(1).trim()));
+  }
+  return makeCriteria("=", parseNumericOrString(str));
+}
+function parseNumericOrString(s) {
+  const n = Number(s);
+  if (!isNaN(n) && s !== "") return n;
+  return s;
+}
+function matchesCriteria(cellValue, criteria) {
+  const { op, value } = criteria;
+  let comparableCell = cellValue;
+  if (typeof value === "number" && typeof cellValue !== "number") {
+    const n = toNumber(cellValue);
+    if (n instanceof FormulaError) return false;
+    comparableCell = n;
+  }
+  if (typeof comparableCell === "string" && criteria.valueLower !== null) {
+    const a = comparableCell.toLowerCase();
+    const b = criteria.valueLower;
+    switch (op) {
+      case "=":
+        return a === b;
+      case "<>":
+        return a !== b;
+      case ">":
+        return a > b;
+      case "<":
+        return a < b;
+      case ">=":
+        return a >= b;
+      case "<=":
+        return a <= b;
+    }
+  }
+  if (typeof comparableCell === "number" && typeof value === "number") {
+    switch (op) {
+      case "=":
+        return comparableCell === value;
+      case "<>":
+        return comparableCell !== value;
+      case ">":
+        return comparableCell > value;
+      case "<":
+        return comparableCell < value;
+      case ">=":
+        return comparableCell >= value;
+      case "<=":
+        return comparableCell <= value;
+    }
+  }
+  if (op === "=") return comparableCell === value;
+  if (op === "<>") return comparableCell !== value;
+  return false;
+}
+function registerStatsFunctions(registry) {
+  registry.set("SUMIF", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "SUMIF range must be a cell range");
+      }
+      const criteriaRange = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const rawCriteria = evaluator.evaluate(args[1], context);
+      if (rawCriteria instanceof FormulaError) return rawCriteria;
+      const criteria = parseCriteria(rawCriteria);
+      let sumRange;
+      if (args.length >= 3) {
+        if (args[2].kind !== "range") {
+          return new FormulaError("#VALUE!", "SUMIF sum_range must be a cell range");
+        }
+        sumRange = context.getRangeValues({ start: args[2].start, end: args[2].end });
+      } else {
+        sumRange = criteriaRange;
+      }
+      let sum = 0;
+      for (let r = 0; r < criteriaRange.length; r++) {
+        for (let c = 0; c < criteriaRange[r].length; c++) {
+          if (matchesCriteria(criteriaRange[r][c], criteria)) {
+            const sumVal = sumRange[r] && sumRange[r][c] !== void 0 ? sumRange[r][c] : null;
+            const n = toNumber(sumVal);
+            if (typeof n === "number") {
+              sum += n;
+            }
+          }
+        }
+      }
+      return sum;
+    }
+  });
+  registry.set("COUNTIF", {
+    minArgs: 2,
+    maxArgs: 2,
+    evaluate(args, context, evaluator) {
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "COUNTIF range must be a cell range");
+      }
+      const rangeData = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const rawCriteria = evaluator.evaluate(args[1], context);
+      if (rawCriteria instanceof FormulaError) return rawCriteria;
+      const criteria = parseCriteria(rawCriteria);
+      let count = 0;
+      for (let r = 0; r < rangeData.length; r++) {
+        for (let c = 0; c < rangeData[r].length; c++) {
+          if (matchesCriteria(rangeData[r][c], criteria)) {
+            count++;
+          }
+        }
+      }
+      return count;
+    }
+  });
+  registry.set("AVERAGEIF", {
+    minArgs: 2,
+    maxArgs: 3,
+    evaluate(args, context, evaluator) {
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "AVERAGEIF range must be a cell range");
+      }
+      const criteriaRange = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const rawCriteria = evaluator.evaluate(args[1], context);
+      if (rawCriteria instanceof FormulaError) return rawCriteria;
+      const criteria = parseCriteria(rawCriteria);
+      let avgRange;
+      if (args.length >= 3) {
+        if (args[2].kind !== "range") {
+          return new FormulaError("#VALUE!", "AVERAGEIF avg_range must be a cell range");
+        }
+        avgRange = context.getRangeValues({ start: args[2].start, end: args[2].end });
+      } else {
+        avgRange = criteriaRange;
+      }
+      let sum = 0;
+      let count = 0;
+      for (let r = 0; r < criteriaRange.length; r++) {
+        for (let c = 0; c < criteriaRange[r].length; c++) {
+          if (matchesCriteria(criteriaRange[r][c], criteria)) {
+            const avgVal = avgRange[r] && avgRange[r][c] !== void 0 ? avgRange[r][c] : null;
+            const n = toNumber(avgVal);
+            if (typeof n === "number") {
+              sum += n;
+              count++;
+            }
+          }
+        }
+      }
+      if (count === 0) return new FormulaError("#DIV/0!", "No matching values for AVERAGEIF");
+      return sum / count;
+    }
+  });
+  registry.set("SUMIFS", {
+    minArgs: 3,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      if ((args.length - 1) % 2 !== 0) {
+        return new FormulaError("#VALUE!", "SUMIFS requires sum_range + pairs of criteria_range, criteria");
+      }
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "SUMIFS sum_range must be a cell range");
+      }
+      const sumRange = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const pairs = [];
+      for (let i = 1; i < args.length; i += 2) {
+        const rangeArg = args[i];
+        if (rangeArg.kind !== "range") {
+          return new FormulaError("#VALUE!", "SUMIFS criteria_range must be a cell range");
+        }
+        const range = context.getRangeValues({ start: rangeArg.start, end: rangeArg.end });
+        const rawCriteria = evaluator.evaluate(args[i + 1], context);
+        if (rawCriteria instanceof FormulaError) return rawCriteria;
+        pairs.push({ range, criteria: parseCriteria(rawCriteria) });
+      }
+      let sum = 0;
+      for (let r = 0; r < sumRange.length; r++) {
+        for (let c = 0; c < sumRange[r].length; c++) {
+          let allMatch = true;
+          for (const pair of pairs) {
+            const cellVal = pair.range[r]?.[c];
+            if (!matchesCriteria(cellVal, pair.criteria)) {
+              allMatch = false;
+              break;
+            }
+          }
+          if (allMatch) {
+            const n = toNumber(sumRange[r][c]);
+            if (typeof n === "number") sum += n;
+          }
+        }
+      }
+      return sum;
+    }
+  });
+  registry.set("COUNTIFS", {
+    minArgs: 2,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      if (args.length % 2 !== 0) {
+        return new FormulaError("#VALUE!", "COUNTIFS requires pairs of criteria_range, criteria");
+      }
+      const pairs = [];
+      for (let i = 0; i < args.length; i += 2) {
+        const rangeArg = args[i];
+        if (rangeArg.kind !== "range") {
+          return new FormulaError("#VALUE!", "COUNTIFS criteria_range must be a cell range");
+        }
+        const range = context.getRangeValues({ start: rangeArg.start, end: rangeArg.end });
+        const rawCriteria = evaluator.evaluate(args[i + 1], context);
+        if (rawCriteria instanceof FormulaError) return rawCriteria;
+        pairs.push({ range, criteria: parseCriteria(rawCriteria) });
+      }
+      const firstRange = pairs[0].range;
+      let count = 0;
+      for (let r = 0; r < firstRange.length; r++) {
+        for (let c = 0; c < firstRange[r].length; c++) {
+          let allMatch = true;
+          for (const pair of pairs) {
+            const cellVal = pair.range[r]?.[c];
+            if (!matchesCriteria(cellVal, pair.criteria)) {
+              allMatch = false;
+              break;
+            }
+          }
+          if (allMatch) count++;
+        }
+      }
+      return count;
+    }
+  });
+  registry.set("AVERAGEIFS", {
+    minArgs: 3,
+    maxArgs: -1,
+    evaluate(args, context, evaluator) {
+      if ((args.length - 1) % 2 !== 0) {
+        return new FormulaError("#VALUE!", "AVERAGEIFS requires avg_range + pairs of criteria_range, criteria");
+      }
+      if (args[0].kind !== "range") {
+        return new FormulaError("#VALUE!", "AVERAGEIFS avg_range must be a cell range");
+      }
+      const avgRange = context.getRangeValues({ start: args[0].start, end: args[0].end });
+      const pairs = [];
+      for (let i = 1; i < args.length; i += 2) {
+        const rangeArg = args[i];
+        if (rangeArg.kind !== "range") {
+          return new FormulaError("#VALUE!", "AVERAGEIFS criteria_range must be a cell range");
+        }
+        const range = context.getRangeValues({ start: rangeArg.start, end: rangeArg.end });
+        const rawCriteria = evaluator.evaluate(args[i + 1], context);
+        if (rawCriteria instanceof FormulaError) return rawCriteria;
+        pairs.push({ range, criteria: parseCriteria(rawCriteria) });
+      }
+      let sum = 0;
+      let count = 0;
+      for (let r = 0; r < avgRange.length; r++) {
+        for (let c = 0; c < avgRange[r].length; c++) {
+          let allMatch = true;
+          for (const pair of pairs) {
+            const cellVal = pair.range[r]?.[c];
+            if (!matchesCriteria(cellVal, pair.criteria)) {
+              allMatch = false;
+              break;
+            }
+          }
+          if (allMatch) {
+            const n = toNumber(avgRange[r][c]);
+            if (typeof n === "number") {
+              sum += n;
+              count++;
+            }
+          }
+        }
+      }
+      if (count === 0) return new FormulaError("#DIV/0!", "No matching values for AVERAGEIFS");
+      return sum / count;
+    }
+  });
+}
+function registerInfoFunctions(registry) {
+  registry.set("ISBLANK", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      return val === null || val === void 0 || val === "";
+    }
+  });
+  registry.set("ISNUMBER", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      return typeof val === "number" && !isNaN(val);
+    }
+  });
+  registry.set("ISTEXT", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      return typeof val === "string";
+    }
+  });
+  registry.set("ISERROR", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      return val instanceof FormulaError;
+    }
+  });
+  registry.set("ISNA", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      return val instanceof FormulaError && val.type === "#N/A";
+    }
+  });
+  registry.set("TYPE", {
+    minArgs: 1,
+    maxArgs: 1,
+    evaluate(args, context, evaluator) {
+      const val = evaluator.evaluate(args[0], context);
+      if (val instanceof FormulaError) return 16;
+      if (typeof val === "number") return 1;
+      if (typeof val === "string") return 2;
+      if (typeof val === "boolean") return 4;
+      if (val === null || val === void 0) return 1;
+      return 1;
+    }
+  });
+}
+function createBuiltInFunctions() {
+  const registry = /* @__PURE__ */ new Map();
+  registerMathFunctions(registry);
+  registerLogicalFunctions(registry);
+  registerLookupFunctions(registry);
+  registerTextFunctions(registry);
+  registerDateFunctions(registry);
+  registerStatsFunctions(registry);
+  registerInfoFunctions(registry);
+  return registry;
+}
+function extractDependencies(node) {
+  const deps = /* @__PURE__ */ new Set();
+  function walk(n) {
+    switch (n.kind) {
+      case "cellRef":
+        deps.add(toCellKey(n.address.col, n.address.row, n.address.sheet));
+        break;
+      case "range": {
+        const sheet = n.start.sheet;
+        const minRow = Math.min(n.start.row, n.end.row);
+        const maxRow = Math.max(n.start.row, n.end.row);
+        const minCol = Math.min(n.start.col, n.end.col);
+        const maxCol = Math.max(n.start.col, n.end.col);
+        for (let r = minRow; r <= maxRow; r++) {
+          for (let c = minCol; c <= maxCol; c++) {
+            deps.add(toCellKey(c, r, sheet));
+          }
+        }
+        break;
+      }
+      case "functionCall":
+        for (const arg of n.args) walk(arg);
+        break;
+      case "binaryOp":
+        walk(n.left);
+        walk(n.right);
+        break;
+      case "unaryOp":
+        walk(n.operand);
+        break;
+    }
+  }
+  walk(node);
+  return deps;
+}
+var FormulaEngine = class {
+  constructor(config) {
+    this.formulas = /* @__PURE__ */ new Map();
+    this.parsedFormulas = /* @__PURE__ */ new Map();
+    this.values = /* @__PURE__ */ new Map();
+    this.depGraph = new DependencyGraph();
+    this.namedRanges = /* @__PURE__ */ new Map();
+    this.sheetAccessors = /* @__PURE__ */ new Map();
+    const builtIns = createBuiltInFunctions();
+    if (config?.customFunctions) {
+      for (const [name, fn] of Object.entries(config.customFunctions)) {
+        builtIns.set(name.toUpperCase(), fn);
+      }
+    }
+    if (config?.namedRanges) {
+      for (const [name, ref] of Object.entries(config.namedRanges)) {
+        this.namedRanges.set(name.toUpperCase(), ref);
+      }
+    }
+    this.evaluator = new FormulaEvaluator(builtIns);
+    this.maxChainLength = config?.maxChainLength ?? 1e3;
+  }
+  /**
+   * Set or clear a formula for a cell.
+   */
+  setFormula(col, row, formula, accessor) {
+    const key = toCellKey(col, row);
+    if (formula === null || formula === "") {
+      const oldValue2 = this.values.get(key);
+      this.formulas.delete(key);
+      this.parsedFormulas.delete(key);
+      this.values.delete(key);
+      this.depGraph.removeDependencies(key);
+      return {
+        updatedCells: oldValue2 !== void 0 ? [{ cellKey: key, col, row, oldValue: oldValue2, newValue: void 0 }] : []
+      };
+    }
+    const expression = formula.startsWith("=") ? formula.slice(1) : formula;
+    let ast;
+    try {
+      const tokens = tokenize(expression);
+      ast = parse(tokens, this.namedRanges);
+    } catch (err) {
+      const error = err instanceof FormulaError ? err : new FormulaError("#ERROR!", String(err));
+      ast = { kind: "error", error };
+    }
+    const deps = extractDependencies(ast);
+    if (deps.has(key) || this.depGraph.wouldCreateCycle(key, deps)) {
+      const oldValue2 = this.values.get(key);
+      const circError = new FormulaError("#CIRC!", "Circular reference detected");
+      this.formulas.set(key, formula);
+      this.parsedFormulas.set(key, ast);
+      this.values.set(key, circError);
+      this.depGraph.setDependencies(key, deps);
+      return {
+        updatedCells: [{ cellKey: key, col, row, oldValue: oldValue2, newValue: circError }]
+      };
+    }
+    this.depGraph.setDependencies(key, deps);
+    this.formulas.set(key, formula);
+    this.parsedFormulas.set(key, ast);
+    const oldValue = this.values.get(key);
+    const context = this.createContext(accessor);
+    const newValue = this.evaluator.evaluate(ast, context);
+    this.values.set(key, newValue);
+    const updatedCells = [
+      { cellKey: key, col, row, oldValue, newValue }
+    ];
+    const recalcOrder = this.depGraph.getRecalcOrder(key);
+    this.recalcCells(recalcOrder, accessor, updatedCells);
+    return { updatedCells };
+  }
+  /**
+   * Notify the engine that a non-formula cell's value changed.
+   */
+  onCellChanged(col, row, accessor) {
+    const key = toCellKey(col, row);
+    const recalcOrder = this.depGraph.getRecalcOrder(key);
+    if (recalcOrder.length === 0) return { updatedCells: [] };
+    const updatedCells = [];
+    this.recalcCells(recalcOrder, accessor, updatedCells);
+    return { updatedCells };
+  }
+  /**
+   * Batch notify: multiple cells changed.
+   */
+  onCellsChanged(cells, accessor) {
+    const keys = cells.map((c) => toCellKey(c.col, c.row));
+    const recalcOrder = this.depGraph.getRecalcOrderBatch(keys);
+    if (recalcOrder.length === 0) return { updatedCells: [] };
+    const updatedCells = [];
+    this.recalcCells(recalcOrder, accessor, updatedCells);
+    return { updatedCells };
+  }
+  /**
+   * Get the current computed value for a cell.
+   */
+  getValue(col, row) {
+    return this.values.get(toCellKey(col, row));
+  }
+  /**
+   * Get the formula string for a cell.
+   */
+  getFormula(col, row) {
+    return this.formulas.get(toCellKey(col, row));
+  }
+  /**
+   * Check if a cell has a formula.
+   */
+  hasFormula(col, row) {
+    return this.formulas.has(toCellKey(col, row));
+  }
+  /**
+   * Register a custom function at runtime.
+   */
+  registerFunction(name, fn) {
+    this.evaluator.registerFunction(name, fn);
+  }
+  /**
+   * Full recalculation of all formulas.
+   */
+  recalcAll(accessor) {
+    const updatedCells = [];
+    const context = this.createContext(accessor);
+    if (this.formulas.size === 0) return { updatedCells };
+    const allFormulaKeys = [];
+    for (const key of this.formulas.keys()) allFormulaKeys.push(key);
+    const recalcOrder = this.depGraph.getRecalcOrderBatch(allFormulaKeys);
+    const ordered = new Set(recalcOrder);
+    for (const key of allFormulaKeys) {
+      if (!ordered.has(key)) {
+        const { col, row } = fromCellKey(key);
+        const ast = this.parsedFormulas.get(key);
+        if (!ast) continue;
+        const oldValue = this.values.get(key);
+        const newValue = this.evaluator.evaluate(ast, context);
+        this.values.set(key, newValue);
+        updatedCells.push({ cellKey: key, col, row, oldValue, newValue });
       }
-      this.redoStack.length = 0;
     }
+    this.recalcCells(recalcOrder, accessor, updatedCells);
+    return { updatedCells };
   }
   /**
-   * Record a single event as a step (shorthand for push([event])).
-   * If a batch is open, accumulates into the batch instead.
+   * Clear all formulas and cached values.
    */
-  record(event) {
-    this.push([event]);
+  clear() {
+    this.formulas.clear();
+    this.parsedFormulas.clear();
+    this.values.clear();
+    this.depGraph.clear();
   }
   /**
-   * Start a batch — subsequent record/push calls accumulate into one undo step.
-   * Has no effect if a batch is already open.
+   * Get all formula entries for serialization.
    */
-  beginBatch() {
-    if (this.batch === null) {
-      this.batch = [];
+  getAllFormulas() {
+    const result = [];
+    for (const [key, formula] of this.formulas) {
+      const { col, row } = fromCellKey(key);
+      result.push({ col, row, formula });
     }
+    return result;
   }
   /**
-   * End a batch — commits all accumulated events as one undo step.
-   * Has no effect if no batch is open or if the batch is empty.
+   * Bulk-load formulas. Recalculates everything.
    */
-  endBatch() {
-    const b = this.batch;
-    this.batch = null;
-    if (!b || b.length === 0) return;
-    this.history.push(b);
-    if (this.history.length > this.maxDepth) {
-      this.history.splice(0, this.history.length - this.maxDepth);
+  loadFormulas(formulas, accessor) {
+    this.clear();
+    for (const { col, row, formula } of formulas) {
+      const key = toCellKey(col, row);
+      const expression = formula.startsWith("=") ? formula.slice(1) : formula;
+      let ast;
+      try {
+        const tokens = tokenize(expression);
+        ast = parse(tokens, this.namedRanges);
+      } catch (err) {
+        const error = err instanceof FormulaError ? err : new FormulaError("#ERROR!", String(err));
+        ast = { kind: "error", error };
+      }
+      this.formulas.set(key, formula);
+      this.parsedFormulas.set(key, ast);
+      const deps = extractDependencies(ast);
+      this.depGraph.setDependencies(key, deps);
     }
-    this.redoStack.length = 0;
+    return this.recalcAll(accessor);
   }
+  // --- Named Ranges ---
   /**
-   * Pop the most recent history entry for undo.
-   * Returns the batch of events (in original order) to be reversed by the caller,
-   * or null if there is nothing to undo.
-   *
-   * The caller is responsible for applying the events in reverse order.
+   * Define a named range (e.g. "Revenue" → "A1:A10").
    */
-  undo() {
-    const lastBatch = this.history.pop();
-    if (!lastBatch) return null;
-    this.redoStack.push(lastBatch);
-    return lastBatch;
+  defineNamedRange(name, ref) {
+    this.namedRanges.set(name.toUpperCase(), ref);
   }
   /**
-   * Pop the most recent redo entry.
-   * Returns the batch of events (in original order) to be re-applied by the caller,
-   * or null if there is nothing to redo.
+   * Remove a named range by name.
    */
-  redo() {
-    const nextBatch = this.redoStack.pop();
-    if (!nextBatch) return null;
-    this.history.push(nextBatch);
-    return nextBatch;
+  removeNamedRange(name) {
+    this.namedRanges.delete(name.toUpperCase());
   }
   /**
-   * Clear all history and redo state.
-   * Does not affect any open batch — call endBatch() first if needed.
+   * Get all named ranges as a Map (name → ref).
    */
-  clear() {
-    this.history = [];
-    this.redoStack = [];
+  getNamedRanges() {
+    return this.namedRanges;
   }
-};
-function validateColumns(columns) {
-  if (!Array.isArray(columns) || columns.length === 0) {
-    console.warn("[OGrid] columns prop is empty or not an array");
-    return;
+  // --- Sheet Accessors ---
+  /**
+   * Register a data accessor for a named sheet (for cross-sheet references).
+   */
+  registerSheet(name, accessor) {
+    this.sheetAccessors.set(name, accessor);
   }
-  const isDev = typeof process !== "undefined" && process.env?.NODE_ENV !== "production";
-  const ids = /* @__PURE__ */ new Set();
-  for (const col of columns) {
-    if (!col.columnId) {
-      console.warn("[OGrid] Column missing columnId:", col);
+  /**
+   * Unregister a sheet accessor.
+   */
+  unregisterSheet(name) {
+    this.sheetAccessors.delete(name);
+  }
+  // --- Formula Auditing ---
+  /**
+   * Get all cells that a cell depends on (deep, transitive precedents).
+   */
+  getPrecedents(col, row) {
+    const key = toCellKey(col, row);
+    const result = [];
+    const visited = /* @__PURE__ */ new Set();
+    const queue = [];
+    const directDeps = this.depGraph.getDependencies(key);
+    for (const dep of directDeps) {
+      if (!visited.has(dep)) {
+        visited.add(dep);
+        queue.push(dep);
+      }
     }
-    if (ids.has(col.columnId)) {
-      console.warn(`[OGrid] Duplicate columnId: "${col.columnId}"`);
+    let head = 0;
+    while (head < queue.length) {
+      const current = queue[head++];
+      const parsed = fromCellKey(current);
+      result.push({
+        cellKey: current,
+        col: parsed.col,
+        row: parsed.row,
+        formula: this.formulas.get(current),
+        value: this.values.has(current) ? this.values.get(current) : void 0
+      });
+      const deps = this.depGraph.getDependencies(current);
+      for (const dep of deps) {
+        if (!visited.has(dep)) {
+          visited.add(dep);
+          queue.push(dep);
+        }
+      }
     }
-    ids.add(col.columnId);
-    if (isDev && col.editable === true && col.cellEditor == null) {
-      console.warn(
-        `[OGrid] Column "${col.columnId}" has editable=true but no cellEditor defined. Cells will not open an editor on double-click. Set cellEditor to 'text', 'select', 'checkbox', 'date', or a custom component.`
-      );
+    return result;
+  }
+  /**
+   * Get all cells that depend on this cell (deep, transitive dependents).
+   */
+  getDependents(col, row) {
+    const key = toCellKey(col, row);
+    const result = [];
+    const visited = /* @__PURE__ */ new Set();
+    const queue = [];
+    const directDeps = this.depGraph.getDependents(key);
+    for (const dep of directDeps) {
+      if (!visited.has(dep)) {
+        visited.add(dep);
+        queue.push(dep);
+      }
     }
+    let head = 0;
+    while (head < queue.length) {
+      const current = queue[head++];
+      const parsed = fromCellKey(current);
+      result.push({
+        cellKey: current,
+        col: parsed.col,
+        row: parsed.row,
+        formula: this.formulas.get(current),
+        value: this.values.has(current) ? this.values.get(current) : void 0
+      });
+      const deps = this.depGraph.getDependents(current);
+      for (const dep of deps) {
+        if (!visited.has(dep)) {
+          visited.add(dep);
+          queue.push(dep);
+        }
+      }
+    }
+    return result;
   }
-}
-function validateVirtualScrollConfig(config) {
-  if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") return;
-  if (config.enabled !== true) return;
-  if (!config.rowHeight || config.rowHeight <= 0) {
-    console.warn(
-      "[OGrid] virtualScroll.enabled is true but rowHeight is missing or <= 0. Set a positive rowHeight (e.g. virtualScroll: { enabled: true, rowHeight: 36 }) for correct virtual scrolling behavior."
-    );
+  /**
+   * Get a full audit trail for a cell: target + precedents + dependents.
+   */
+  getAuditTrail(col, row) {
+    const key = toCellKey(col, row);
+    const target = {
+      cellKey: key,
+      col,
+      row,
+      formula: this.formulas.get(key),
+      value: this.values.has(key) ? this.values.get(key) : void 0
+    };
+    return {
+      target,
+      precedents: this.getPrecedents(col, row),
+      dependents: this.getDependents(col, row)
+    };
   }
-}
-function validateRowIds(items, getRowId) {
-  if (typeof process !== "undefined" && process.env.NODE_ENV === "production") return;
-  if (!getRowId) return;
-  const ids = /* @__PURE__ */ new Set();
-  const limit = Math.min(items.length, 100);
-  for (let i = 0; i < limit; i++) {
-    const id = getRowId(items[i]);
-    if (id == null) {
-      console.warn(`[OGrid] getRowId returned null/undefined for row ${i}`);
-      return;
-    }
-    if (ids.has(id)) {
-      console.warn(
-        `[OGrid] Duplicate row ID "${id}" at index ${i}. getRowId must return unique values.`
-      );
-      return;
+  // --- Private methods ---
+  createContext(accessor) {
+    const contextNow = /* @__PURE__ */ new Date();
+    return {
+      getCellValue: (addr) => {
+        const key = toCellKey(addr.col, addr.row, addr.sheet);
+        const cached = this.values.get(key);
+        if (cached !== void 0) return cached;
+        if (addr.sheet) {
+          const sheetAccessor = this.sheetAccessors.get(addr.sheet);
+          if (!sheetAccessor) return new FormulaError("#REF!", `Unknown sheet: ${addr.sheet}`);
+          return sheetAccessor.getCellValue(addr.col, addr.row);
+        }
+        return accessor.getCellValue(addr.col, addr.row);
+      },
+      getRangeValues: (range) => {
+        const result = [];
+        const sheet = range.start.sheet;
+        const rangeAccessor = sheet ? this.sheetAccessors.get(sheet) : accessor;
+        if (sheet && !rangeAccessor) {
+          return [[new FormulaError("#REF!", `Unknown sheet: ${sheet}`)]];
+        }
+        const minRow = Math.min(range.start.row, range.end.row);
+        const maxRow = Math.max(range.start.row, range.end.row);
+        const minCol = Math.min(range.start.col, range.end.col);
+        const maxCol = Math.max(range.start.col, range.end.col);
+        for (let r = minRow; r <= maxRow; r++) {
+          const row = [];
+          for (let c = minCol; c <= maxCol; c++) {
+            const key = toCellKey(c, r, sheet);
+            const cached = this.values.get(key);
+            if (cached !== void 0) {
+              row.push(cached);
+            } else {
+              row.push(rangeAccessor.getCellValue(c, r));
+            }
+          }
+          result.push(row);
+        }
+        return result;
+      },
+      now: () => contextNow
+    };
+  }
+  recalcCells(order, accessor, updatedCells) {
+    const context = this.createContext(accessor);
+    let count = 0;
+    for (const key of order) {
+      if (count++ > this.maxChainLength) {
+        const { col: col2, row: row2 } = fromCellKey(key);
+        const oldValue2 = this.values.get(key);
+        const circError = new FormulaError("#CIRC!", "Dependency chain too long");
+        this.values.set(key, circError);
+        updatedCells.push({ cellKey: key, col: col2, row: row2, oldValue: oldValue2, newValue: circError });
+        continue;
+      }
+      const ast = this.parsedFormulas.get(key);
+      if (!ast) continue;
+      const { col, row } = fromCellKey(key);
+      const oldValue = this.values.get(key);
+      const newValue = this.evaluator.evaluate(ast, context);
+      this.values.set(key, newValue);
+      updatedCells.push({ cellKey: key, col, row, oldValue, newValue });
     }
-    ids.add(id);
   }
-}
-var DEFAULT_DEBOUNCE_MS = 300;
-var PEOPLE_SEARCH_DEBOUNCE_MS = DEFAULT_DEBOUNCE_MS;
+};
 function useLatestRef(value) {
   const ref = useRef(value);
   ref.current = value;
@@ -1569,8 +5181,8 @@ function useFilterOptions(dataSource, fields) {
 function resolveCellDisplayContent2(col, item, displayValue) {
   return resolveCellDisplayContent(col, item, displayValue);
 }
-function resolveCellStyle2(col, item) {
-  return resolveCellStyle(col, item);
+function resolveCellStyle2(col, item, displayValue) {
+  return resolveCellStyle(col, item, displayValue);
 }
 function buildInlineEditorProps2(item, col, descriptor, callbacks) {
   const result = buildInlineEditorProps(item, col, descriptor, callbacks);
@@ -1584,6 +5196,7 @@ function getCellInteractionProps(descriptor, columnId, handlers) {
   return {
     "data-row-index": descriptor.rowIndex,
     "data-col-index": descriptor.globalColIndex,
+    ...descriptor.isActive ? { "data-active-cell": "true" } : {},
     ...descriptor.isInRange ? { "data-in-range": "true" } : {},
     tabIndex: descriptor.isActive ? 0 : -1,
     onMouseDown: (e) => handlers.handleCellMouseDown(e, descriptor.rowIndex, descriptor.globalColIndex),
@@ -1595,6 +5208,127 @@ function getCellInteractionProps(descriptor, columnId, handlers) {
     } : {}
   };
 }
+var NOOP_RESULT = {
+  getFormulaValue: () => void 0,
+  hasFormula: () => false,
+  getFormula: () => void 0,
+  setFormula: () => {
+  },
+  onCellChanged: () => {
+  },
+  getPrecedents: () => [],
+  getDependents: () => [],
+  getAuditTrail: () => null,
+  enabled: false
+};
+function useFormulaEngine(params) {
+  const {
+    formulas,
+    items,
+    flatColumns,
+    initialFormulas,
+    onFormulaRecalc,
+    formulaFunctions,
+    namedRanges,
+    sheets
+  } = params;
+  const itemsRef = useLatestRef(items);
+  const flatColumnsRef = useLatestRef(flatColumns);
+  const onFormulaRecalcRef = useLatestRef(onFormulaRecalc);
+  const engineRef = useRef(null);
+  if (formulas && !engineRef.current) {
+    engineRef.current = new FormulaEngine({
+      customFunctions: formulaFunctions,
+      namedRanges
+    });
+  } else if (!formulas && engineRef.current) {
+    engineRef.current = null;
+  }
+  useEffect(() => {
+    if (!engineRef.current || !sheets) return;
+    for (const [name, accessor] of Object.entries(sheets)) {
+      engineRef.current.registerSheet(name, accessor);
+    }
+    return () => {
+      if (!engineRef.current || !sheets) return;
+      for (const name of Object.keys(sheets)) {
+        engineRef.current.unregisterSheet(name);
+      }
+    };
+  }, [sheets]);
+  const createAccessor = useCallback(() => {
+    const currentItems = itemsRef.current;
+    const currentCols = flatColumnsRef.current;
+    return {
+      getCellValue: (col, row) => {
+        if (row < 0 || row >= currentItems.length) return null;
+        if (col < 0 || col >= currentCols.length) return null;
+        return getCellValue(currentItems[row], currentCols[col]);
+      },
+      getRowCount: () => currentItems.length,
+      getColumnCount: () => currentCols.length
+    };
+  }, [itemsRef, flatColumnsRef]);
+  const initialLoadedRef = useRef(false);
+  useEffect(() => {
+    if (formulas && engineRef.current && initialFormulas && !initialLoadedRef.current) {
+      initialLoadedRef.current = true;
+      const accessor = createAccessor();
+      const result = engineRef.current.loadFormulas(initialFormulas, accessor);
+      if (result.updatedCells.length > 0) {
+        onFormulaRecalcRef.current?.(result);
+      }
+    }
+  }, [formulas, initialFormulas, createAccessor, onFormulaRecalcRef]);
+  const getFormulaValue = useCallback((col, row) => {
+    return engineRef.current?.getValue(col, row);
+  }, []);
+  const hasFormula = useCallback((col, row) => {
+    return engineRef.current?.hasFormula(col, row) ?? false;
+  }, []);
+  const getFormula = useCallback((col, row) => {
+    return engineRef.current?.getFormula(col, row);
+  }, []);
+  const setFormula = useCallback((col, row, formula) => {
+    if (!engineRef.current) return;
+    const accessor = createAccessor();
+    const result = engineRef.current.setFormula(col, row, formula, accessor);
+    if (result.updatedCells.length > 0) {
+      onFormulaRecalcRef.current?.(result);
+    }
+  }, [createAccessor, onFormulaRecalcRef]);
+  const onCellChanged = useCallback((col, row) => {
+    if (!engineRef.current) return;
+    const accessor = createAccessor();
+    const result = engineRef.current.onCellChanged(col, row, accessor);
+    if (result.updatedCells.length > 0) {
+      onFormulaRecalcRef.current?.(result);
+    }
+  }, [createAccessor, onFormulaRecalcRef]);
+  const getPrecedents = useCallback((col, row) => {
+    return engineRef.current?.getPrecedents(col, row) ?? [];
+  }, []);
+  const getDependents = useCallback((col, row) => {
+    return engineRef.current?.getDependents(col, row) ?? [];
+  }, []);
+  const getAuditTrail = useCallback((col, row) => {
+    return engineRef.current?.getAuditTrail(col, row) ?? null;
+  }, []);
+  return useMemo(() => {
+    if (!formulas) return NOOP_RESULT;
+    return {
+      getFormulaValue,
+      hasFormula,
+      getFormula,
+      setFormula,
+      onCellChanged,
+      getPrecedents,
+      getDependents,
+      getAuditTrail,
+      enabled: true
+    };
+  }, [formulas, getFormulaValue, hasFormula, getFormula, setFormula, onCellChanged, getPrecedents, getDependents, getAuditTrail]);
+}
 function useOGridPagination(params) {
   const { controlledPage, controlledPageSize, defaultPageSize, onPageChange, onPageSizeChange } = params;
   const [internalPage, setInternalPage] = useState(1);
@@ -1719,11 +5453,13 @@ function useOGridDataFetching(params) {
     page,
     pageSize,
     onError,
-    onFirstDataRendered
+    onFirstDataRendered,
+    workerSort
   } = params;
   const isClientSide = !isServerSide;
+  const useWorker = workerSort === true || workerSort === "auto" && displayData.length > 5e3;
   const clientItemsAndTotal = useMemo(() => {
-    if (!isClientSide) return null;
+    if (!isClientSide || useWorker) return null;
     const rows = processClientSideData(
       displayData,
       columns,
@@ -1735,7 +5471,29 @@ function useOGridDataFetching(params) {
     const start = (page - 1) * pageSize;
     const paged = rows.slice(start, start + pageSize);
     return { items: paged, totalCount: total };
-  }, [isClientSide, displayData, columns, stableFilters, sort.field, sort.direction, page, pageSize]);
+  }, [isClientSide, useWorker, displayData, columns, stableFilters, sort.field, sort.direction, page, pageSize]);
+  const [asyncItems, setAsyncItems] = useState(null);
+  const asyncIdRef = useRef(0);
+  useEffect(() => {
+    if (!isClientSide || !useWorker) {
+      setAsyncItems(null);
+      return;
+    }
+    const id = ++asyncIdRef.current;
+    processClientSideDataAsync(
+      displayData,
+      columns,
+      stableFilters,
+      sort.field,
+      sort.direction
+    ).then((rows) => {
+      if (id !== asyncIdRef.current) return;
+      const total = rows.length;
+      const start = (page - 1) * pageSize;
+      const paged = rows.slice(start, start + pageSize);
+      setAsyncItems({ items: paged, totalCount: total });
+    });
+  }, [isClientSide, useWorker, displayData, columns, stableFilters, sort.field, sort.direction, page, pageSize]);
   const [serverItems, setServerItems] = useState([]);
   const [serverTotalCount, setServerTotalCount] = useState(0);
   const [serverLoading, setServerLoading] = useState(true);
@@ -1769,8 +5527,9 @@ function useOGridDataFetching(params) {
       if (id === fetchIdRef.current) setServerLoading(false);
     });
   }, [isServerSide, page, pageSize, sort.field, sort.direction, stableFilters, refreshCounter, dataSourceRef, onErrorRef]);
-  const displayItems = isClientSide && clientItemsAndTotal ? clientItemsAndTotal.items : serverItems;
-  const displayTotalCount = isClientSide && clientItemsAndTotal ? clientItemsAndTotal.totalCount : serverTotalCount;
+  const clientResult = clientItemsAndTotal ?? asyncItems;
+  const displayItems = isClientSide && clientResult ? clientResult.items : serverItems;
+  const displayTotalCount = isClientSide && clientResult ? clientResult.totalCount : serverTotalCount;
   const onFirstDataRenderedRef = useLatestRef(onFirstDataRendered);
   const firstDataRenderedRef = useRef(false);
   useEffect(() => {
@@ -1823,6 +5582,20 @@ function useSideBarState(params) {
 // src/hooks/useOGrid.ts
 var DEFAULT_PAGE_SIZE = 25;
 var EMPTY_LOADING_OPTIONS2 = {};
+var NAME_BOX_STYLE = {
+  fontFamily: "monospace",
+  fontSize: "12px",
+  fontWeight: 500,
+  padding: "2px 8px",
+  border: "1px solid var(--ogrid-border, #e0e0e0)",
+  borderRadius: 3,
+  background: "var(--ogrid-bg, #fff)",
+  color: "var(--ogrid-fg, #242424)",
+  minWidth: 48,
+  textAlign: "center",
+  lineHeight: "20px",
+  userSelect: "none"
+};
 function useOGrid(props, ref) {
   const {
     columns: columnsProp,
@@ -1865,6 +5638,7 @@ function useOGrid(props, ref) {
     selectedRows,
     onSelectionChange,
     showRowNumbers,
+    cellReferences,
     statusBar,
     pageSizeOptions,
     sideBar,
@@ -1877,6 +5651,13 @@ function useOGrid(props, ref) {
     virtualScroll,
     rowHeight,
     density = "normal",
+    workerSort,
+    formulas,
+    initialFormulas,
+    onFormulaRecalc,
+    formulaFunctions,
+    namedRanges,
+    sheets,
     "aria-label": ariaLabel,
     "aria-labelledby": ariaLabelledBy
   } = props;
@@ -1950,7 +5731,8 @@ function useOGrid(props, ref) {
     page: paginationState.page,
     pageSize: paginationState.pageSize,
     onError,
-    onFirstDataRendered
+    onFirstDataRendered,
+    workerSort
   });
   useEffect(() => {
     const items = dataFetchingState.displayItems;
@@ -2008,7 +5790,13 @@ function useOGrid(props, ref) {
     [selectedRows, onSelectionChange]
   );
   const [columnWidthOverrides, setColumnWidthOverrides] = useState({});
-  const [pinnedOverrides, setPinnedOverrides] = useState({});
+  const [pinnedOverrides, setPinnedOverrides] = useState(() => {
+    const initial = {};
+    for (const col of flattenColumns(columnsProp)) {
+      if (col.pinned) initial[col.columnId] = col.pinned;
+    }
+    return initial;
+  });
   const handleColumnResized = useCallback(
     (columnId, width) => {
       setColumnWidthOverrides((prev) => ({ ...prev, [columnId]: width }));
@@ -2176,8 +5964,22 @@ function useOGrid(props, ref) {
     filtersState.handleFilterChange,
     filtersState.clientFilterOptions
   ]);
+  const formulaEngine = useFormulaEngine({
+    formulas,
+    items: dataFetchingState.displayItems,
+    flatColumns: columns,
+    initialFormulas,
+    onFormulaRecalc,
+    formulaFunctions,
+    namedRanges,
+    sheets
+  });
   const clearAllFilters = useCallback(() => filtersState.setFilters({}), [filtersState]);
   const isLoadingResolved = isServerSide && dataFetchingState.serverLoading || displayLoading;
+  const [activeCellRef, setActiveCellRef] = useState(null);
+  const onActiveCellChange = useCallback((ref2) => {
+    setActiveCellRef(ref2);
+  }, []);
   const dataGridProps = useMemo(() => ({
     items: dataFetchingState.displayItems,
     columns: columnsProp,
@@ -2202,7 +6004,10 @@ function useOGrid(props, ref) {
     rowSelection,
     selectedRows: effectiveSelectedRows,
     onSelectionChange: handleSelectionChange,
-    showRowNumbers,
+    showRowNumbers: showRowNumbers || cellReferences,
+    showColumnLetters: !!cellReferences,
+    showNameBox: !!cellReferences,
+    onActiveCellChange: cellReferences ? onActiveCellChange : void 0,
     currentPage: paginationState.page,
     pageSize: paginationState.pageSize,
     statusBar: statusBarConfig,
@@ -2227,7 +6032,16 @@ function useOGrid(props, ref) {
       onClearAll: clearAllFilters,
       message: emptyState?.message,
       render: emptyState?.render
-    }
+    },
+    formulas,
+    getFormulaValue: formulaEngine.enabled ? formulaEngine.getFormulaValue : void 0,
+    hasFormula: formulaEngine.enabled ? formulaEngine.hasFormula : void 0,
+    getFormula: formulaEngine.enabled ? formulaEngine.getFormula : void 0,
+    setFormula: formulaEngine.enabled ? formulaEngine.setFormula : void 0,
+    onFormulaCellChanged: formulaEngine.enabled ? formulaEngine.onCellChanged : void 0,
+    getPrecedents: formulaEngine.enabled ? formulaEngine.getPrecedents : void 0,
+    getDependents: formulaEngine.enabled ? formulaEngine.getDependents : void 0,
+    getAuditTrail: formulaEngine.enabled ? formulaEngine.getAuditTrail : void 0
   }), [
     dataFetchingState.displayItems,
     columnsProp,
@@ -2253,6 +6067,8 @@ function useOGrid(props, ref) {
     effectiveSelectedRows,
     handleSelectionChange,
     showRowNumbers,
+    cellReferences,
+    onActiveCellChange,
     paginationState.page,
     paginationState.pageSize,
     statusBarConfig,
@@ -2273,7 +6089,9 @@ function useOGrid(props, ref) {
     ariaLabelledBy,
     filtersState.hasActiveFilters,
     clearAllFilters,
-    emptyState
+    emptyState,
+    formulas,
+    formulaEngine
   ]);
   const pagination = useMemo(() => ({
     page: paginationState.page,
@@ -2291,14 +6109,20 @@ function useOGrid(props, ref) {
     onSetVisibleColumns: setVisibleColumns,
     placement: columnChooserPlacement
   }), [columnChooserColumns, visibleColumns, handleVisibilityChange, setVisibleColumns, columnChooserPlacement]);
+  const showNameBox = !!cellReferences;
+  const nameBoxEl = useMemo(() => showNameBox ? React5.createElement("div", {
+    style: NAME_BOX_STYLE,
+    "aria-label": "Active cell reference"
+  }, activeCellRef ?? "\u2014") : null, [showNameBox, activeCellRef]);
+  const resolvedToolbar = useMemo(() => showNameBox ? React5.createElement(React5.Fragment, null, nameBoxEl, toolbar) : toolbar, [showNameBox, nameBoxEl, toolbar]);
   const layout = useMemo(() => ({
-    toolbar,
+    toolbar: resolvedToolbar,
     toolbarBelow,
     className,
     emptyState,
     sideBarProps,
     fullScreen
-  }), [toolbar, toolbarBelow, className, emptyState, sideBarProps, fullScreen]);
+  }), [resolvedToolbar, toolbarBelow, className, emptyState, sideBarProps, fullScreen]);
   const filtersResult = useMemo(() => ({
     hasActiveFilters: filtersState.hasActiveFilters,
     setFilters: filtersState.setFilters
@@ -2724,6 +6548,11 @@ function useClipboard(params) {
   const activeCellRef = useLatestRef(params.activeCell);
   const editableRef = useLatestRef(params.editable);
   const onCellValueChangedRef = useLatestRef(params.onCellValueChanged);
+  const formulasRef = useLatestRef(params.formulas);
+  const flatColumnsRef = useLatestRef(params.flatColumns);
+  const getFormulaRef = useLatestRef(params.getFormula);
+  const hasFormulaRef = useLatestRef(params.hasFormula);
+  const setFormulaRef = useLatestRef(params.setFormula);
   const cutRangeRef = useRef(null);
   const [cutRange, setCutRange] = useState(null);
   const [copyRange, setCopyRange] = useState(null);
@@ -2741,12 +6570,18 @@ function useClipboard(params) {
     const range = getEffectiveRange();
     if (range == null) return;
     const norm = normalizeSelectionRange(range);
-    const tsv = formatSelectionAsTsv(itemsRef.current, visibleColsRef.current, norm);
+    const formulaOptions = formulasRef.current && flatColumnsRef.current ? {
+      colOffset,
+      flatColumns: flatColumnsRef.current,
+      getFormula: getFormulaRef.current,
+      hasFormula: hasFormulaRef.current
+    } : void 0;
+    const tsv = formatSelectionAsTsv(itemsRef.current, visibleColsRef.current, norm, formulaOptions);
     internalClipboardRef.current = tsv;
     setCopyRange(norm);
     void navigator.clipboard.writeText(tsv).catch(() => {
     });
-  }, [getEffectiveRange, itemsRef, visibleColsRef]);
+  }, [getEffectiveRange, itemsRef, visibleColsRef, formulasRef, flatColumnsRef, getFormulaRef, hasFormulaRef, colOffset]);
   const handleCut = useCallback(() => {
     if (editableRef.current === false) return;
     const range = getEffectiveRange();
@@ -2779,8 +6614,13 @@ function useClipboard(params) {
     const items = itemsRef.current;
     const visibleCols = visibleColsRef.current;
     const parsedRows = parseTsvClipboard(text);
+    const formulaOptions = formulasRef.current && flatColumnsRef.current ? {
+      colOffset,
+      flatColumns: flatColumnsRef.current,
+      setFormula: setFormulaRef.current
+    } : void 0;
     beginBatch?.();
-    const pasteEvents = applyPastedValues(parsedRows, anchorRow, anchorCol, items, visibleCols);
+    const pasteEvents = applyPastedValues(parsedRows, anchorRow, anchorCol, items, visibleCols, formulaOptions);
     for (const evt of pasteEvents) onCellValueChanged(evt);
     if (cutRangeRef.current) {
       const cutEvents = applyCutClear(cutRangeRef.current, items, visibleCols);
@@ -2790,7 +6630,7 @@ function useClipboard(params) {
     }
     endBatch?.();
     setCopyRange(null);
-  }, [getEffectiveRange, itemsRef, visibleColsRef, editableRef, onCellValueChangedRef, beginBatch, endBatch]);
+  }, [getEffectiveRange, itemsRef, visibleColsRef, editableRef, onCellValueChangedRef, beginBatch, endBatch, formulasRef, flatColumnsRef, setFormulaRef, colOffset]);
   const clearClipboardRanges = useCallback(() => {
     setCopyRange(null);
     setCutRange(null);
@@ -2896,7 +6736,9 @@ function useKeyboardNavigation(params) {
           "Tab",
           "Enter",
           "Home",
-          "End"
+          "End",
+          "PageDown",
+          "PageUp"
         ].includes(e.key)) {
           setActiveCell({ rowIndex: 0, columnIndex: colOffset });
           e.preventDefault();
@@ -3000,6 +6842,42 @@ function useKeyboardNavigation(params) {
           setActiveCell({ rowIndex: newRowEnd, columnIndex: maxColIndex });
           break;
         }
+        case "PageDown":
+        case "PageUp": {
+          e.preventDefault();
+          const wrapper = wrapperRef.current;
+          let pageSize = 10;
+          let rowHeight = 36;
+          if (wrapper) {
+            const firstRow = wrapper.querySelector("tbody tr");
+            if (firstRow && firstRow.offsetHeight > 0) {
+              rowHeight = firstRow.offsetHeight;
+              pageSize = Math.max(1, Math.floor(wrapper.clientHeight / rowHeight));
+            }
+          }
+          const pgDirection = e.key === "PageDown" ? 1 : -1;
+          const newRowPage = Math.max(0, Math.min(rowIndex + pgDirection * pageSize, maxRowIndex));
+          if (shift) {
+            setSelectionRange({
+              startRow: selectionRange?.startRow ?? rowIndex,
+              startCol: selectionRange?.startCol ?? dataColIndex,
+              endRow: newRowPage,
+              endCol: selectionRange?.endCol ?? dataColIndex
+            });
+          } else {
+            setSelectionRange({
+              startRow: newRowPage,
+              startCol: dataColIndex,
+              endRow: newRowPage,
+              endCol: dataColIndex
+            });
+          }
+          setActiveCell({ rowIndex: newRowPage, columnIndex });
+          if (wrapper) {
+            wrapper.scrollTop = getScrollTopForRow(newRowPage, rowHeight, wrapper.clientHeight, "center");
+          }
+          break;
+        }
         case "Enter":
         case "F2": {
           e.preventDefault();
@@ -3222,7 +7100,8 @@ function useFillHandle(params) {
     colOffset,
     wrapperRef,
     beginBatch,
-    endBatch
+    endBatch,
+    formulaOptions
   } = params;
   const onCellValueChangedRef = useLatestRef(onCellValueChangedProp);
   const [fillDrag, setFillDrag] = useState(null);
@@ -3328,7 +7207,7 @@ function useFillHandle(params) {
       });
       setSelectionRange(norm);
       setActiveCell({ rowIndex: fillDrag.startRow, columnIndex: fillDrag.startCol + colOffsetRef.current });
-      const fillEvents = applyFillValues(norm, fillDrag.startRow, fillDrag.startCol, items, visibleCols);
+      const fillEvents = applyFillValues(norm, fillDrag.startRow, fillDrag.startCol, items, visibleCols, formulaOptions);
       if (fillEvents.length > 0) {
         beginBatch?.();
         for (const evt of fillEvents) onCellValueChangedRef.current?.(evt);
@@ -3383,7 +7262,8 @@ function useFillHandle(params) {
       norm.startRow,
       norm.startCol,
       itemsRef.current,
-      visibleColsRef.current
+      visibleColsRef.current,
+      formulaOptions
     );
     if (fillEvents.length > 0) {
       beginBatch?.();
@@ -3854,14 +7734,38 @@ function useDataGridEditing(params) {
     onCellValueChanged,
     setActiveCell,
     setSelectionRange,
-    colOffset
+    colOffset,
+    setFormula,
+    onFormulaCellChanged,
+    formulas,
+    flatColumns
   } = params;
   const [popoverAnchorEl, setPopoverAnchorEl] = useState(null);
   const visibleColsRef = useLatestRef(params.visibleCols);
   const itemsLengthRef = useLatestRef(params.itemsLength);
   const onCellValueChangedRef = useLatestRef(onCellValueChanged);
+  const setFormulaRef = useLatestRef(setFormula);
+  const onFormulaCellChangedRef = useLatestRef(onFormulaCellChanged);
+  const flatColumnsRef = useLatestRef(flatColumns);
   const commitCellEdit = useCallback(
     (item, columnId, oldValue, newValue, rowIndex, globalColIndex) => {
+      if (formulas && typeof newValue === "string" && newValue.startsWith("=") && setFormulaRef.current) {
+        const cols = flatColumnsRef.current;
+        const colIndex = cols ? cols.findIndex((c) => c.columnId === columnId) : -1;
+        if (colIndex >= 0) {
+          setFormulaRef.current(colIndex, rowIndex, newValue);
+          setEditingCell(null);
+          setPopoverAnchorEl(null);
+          setPendingEditorValue(void 0);
+          if (rowIndex < itemsLengthRef.current - 1) {
+            const newRow = rowIndex + 1;
+            const localCol = globalColIndex - colOffset;
+            setActiveCell({ rowIndex: newRow, columnIndex: globalColIndex });
+            setSelectionRange({ startRow: newRow, startCol: localCol, endRow: newRow, endCol: localCol });
+          }
+          return;
+        }
+      }
       const col = visibleColsRef.current.find((c) => c.columnId === columnId);
       if (col) {
         const result = parseValue(newValue, oldValue, item, col);
@@ -3880,6 +7784,12 @@ function useDataGridEditing(params) {
         newValue,
         rowIndex
       });
+      if (formulas && onFormulaCellChangedRef.current && flatColumnsRef.current) {
+        const colIndex = flatColumnsRef.current.findIndex((c) => c.columnId === columnId);
+        if (colIndex >= 0) {
+          onFormulaCellChangedRef.current(colIndex, rowIndex);
+        }
+      }
       setEditingCell(null);
       setPopoverAnchorEl(null);
       setPendingEditorValue(void 0);
@@ -3890,7 +7800,7 @@ function useDataGridEditing(params) {
         setSelectionRange({ startRow: newRow, startCol: localCol, endRow: newRow, endCol: localCol });
       }
     },
-    [setEditingCell, setPendingEditorValue, setActiveCell, setSelectionRange, colOffset, visibleColsRef, itemsLengthRef, onCellValueChangedRef]
+    [formulas, setEditingCell, setPendingEditorValue, setActiveCell, setSelectionRange, colOffset, visibleColsRef, itemsLengthRef, onCellValueChangedRef, setFormulaRef, onFormulaCellChangedRef, flatColumnsRef]
   );
   const cancelPopoverEdit = useCallback(() => {
     setEditingCell(null);
@@ -3937,7 +7847,12 @@ function useDataGridInteraction(params) {
     handleRowCheckboxChange,
     setContextMenuPosition,
     wrapperRef,
-    onKeyDown
+    onKeyDown,
+    formulas,
+    flatColumns,
+    getFormula,
+    hasFormula,
+    setFormula
   } = params;
   const undoRedo = useUndoRedo({ onCellValueChanged: onCellValueChangedProp });
   const onCellValueChanged = undoRedo.onCellValueChanged;
@@ -3963,7 +7878,12 @@ function useDataGridInteraction(params) {
     editable,
     onCellValueChanged,
     beginBatch: undoRedo.beginBatch,
-    endBatch: undoRedo.endBatch
+    endBatch: undoRedo.endBatch,
+    formulas,
+    flatColumns,
+    getFormula,
+    hasFormula,
+    setFormula
   });
   const handleCellMouseDown = useCallback(
     (e, rowIndex, globalColIndex) => {
@@ -3974,6 +7894,10 @@ function useDataGridInteraction(params) {
     },
     [handleCellMouseDownBase, clearClipboardRanges, wrapperRef]
   );
+  const fillFormulaOptions = useMemo(() => {
+    if (!formulas || !flatColumns) return void 0;
+    return { flatColumns, getFormula, hasFormula, setFormula };
+  }, [formulas, flatColumns, getFormula, hasFormula, setFormula]);
   const { handleFillHandleMouseDown, fillDown } = useFillHandle({
     items,
     visibleCols,
@@ -3985,7 +7909,8 @@ function useDataGridInteraction(params) {
     colOffset,
     wrapperRef,
     beginBatch: undoRedo.beginBatch,
-    endBatch: undoRedo.endBatch
+    endBatch: undoRedo.endBatch,
+    formulaOptions: fillFormulaOptions
   });
   const { handleGridKeyDown } = useKeyboardNavigation({
     data: { items, visibleCols, colOffset, hasCheckboxCol, visibleColumnCount, getRowId },
@@ -4165,7 +8090,12 @@ function useDataGridState(params) {
     handleRowCheckboxChange,
     setContextMenuPosition,
     wrapperRef,
-    onKeyDown
+    onKeyDown,
+    formulas: props.formulas,
+    flatColumns: layoutResult.layout.flatColumns,
+    getFormula: props.getFormula,
+    hasFormula: props.hasFormula,
+    setFormula: props.setFormula
   });
   const {
     selectionRange,
@@ -4185,7 +8115,11 @@ function useDataGridState(params) {
     onCellValueChanged,
     setActiveCell,
     setSelectionRange,
-    colOffset
+    colOffset,
+    setFormula: props.setFormula,
+    onFormulaCellChanged: props.onFormulaCellChanged,
+    formulas: props.formulas,
+    flatColumns: layoutResult.layout.flatColumns
   });
   const {
     sortBy,
@@ -4714,7 +8648,7 @@ function useInlineCellEditorState(params) {
         e.stopPropagation();
         onCancel();
       }
-      if (e.key === "Enter" && editorType === "text") {
+      if (e.key === "Enter" && (editorType === "text" || editorType === "date")) {
         e.preventDefault();
         e.stopPropagation();
         onCommit(localValue);
@@ -4723,7 +8657,7 @@ function useInlineCellEditorState(params) {
     [onCancel, onCommit, localValue, editorType]
   );
   const handleBlur = useCallback(() => {
-    if (editorType === "text") {
+    if (editorType === "text" || editorType === "date") {
       onCommit(localValue);
     }
   }, [editorType, localValue, onCommit]);
@@ -5975,12 +9909,12 @@ function calculateRange({
 }
 
 // ../../node_modules/@tanstack/react-virtual/dist/esm/index.js
-var useIsomorphicLayoutEffect = typeof document !== "undefined" ? React4.useLayoutEffect : React4.useEffect;
+var useIsomorphicLayoutEffect = typeof document !== "undefined" ? React5.useLayoutEffect : React5.useEffect;
 function useVirtualizerBase({
   useFlushSync = true,
   ...options
 }) {
-  const rerender = React4.useReducer(() => ({}), {})[1];
+  const rerender = React5.useReducer(() => ({}), {})[1];
   const resolvedOptions = {
     ...options,
     onChange: (instance2, sync) => {
@@ -5993,7 +9927,7 @@ function useVirtualizerBase({
       (_a = options.onChange) == null ? void 0 : _a.call(options, instance2, sync);
     }
   };
-  const [instance] = React4.useState(
+  const [instance] = React5.useState(
     () => new Virtualizer(resolvedOptions)
   );
   instance.setOptions(resolvedOptions);
@@ -6023,7 +9957,10 @@ function useVirtualScroll(params) {
     enabled,
     overscan = 5,
     threshold = DEFAULT_PASSTHROUGH_THRESHOLD,
-    containerRef
+    containerRef,
+    columnVirtualization = false,
+    columnWidths,
+    columnOverscan = 2
   } = params;
   useEffect(() => {
     validateVirtualScrollConfig({ enabled, rowHeight });
@@ -6082,11 +10019,51 @@ function useVirtualScroll(params) {
     },
     [isActive, containerRef, rowHeight]
   );
+  const [scrollLeft, setScrollLeft] = useState(0);
+  const scrollLeftRaf = useRef(0);
+  const onHorizontalScroll = useCallback(
+    (sl) => {
+      if (scrollLeftRaf.current) cancelAnimationFrame(scrollLeftRaf.current);
+      scrollLeftRaf.current = requestAnimationFrame(() => {
+        scrollLeftRaf.current = 0;
+        setScrollLeft(sl);
+      });
+    },
+    []
+  );
+  useEffect(() => {
+    return () => {
+      if (scrollLeftRaf.current) cancelAnimationFrame(scrollLeftRaf.current);
+    };
+  }, []);
+  const [containerWidth, setContainerWidth] = useState(0);
+  useEffect(() => {
+    if (!columnVirtualization) return;
+    const el = containerRef.current;
+    if (!el) return;
+    setContainerWidth(el.clientWidth);
+    if (typeof ResizeObserver === "undefined") return;
+    const ro = new ResizeObserver((entries) => {
+      if (entries.length > 0) {
+        setContainerWidth(entries[0].contentRect.width);
+      }
+    });
+    ro.observe(el);
+    return () => ro.disconnect();
+  }, [columnVirtualization, containerRef]);
+  const columnRange = useMemo(() => {
+    if (!columnVirtualization || !columnWidths || columnWidths.length === 0 || containerWidth <= 0) {
+      return null;
+    }
+    return computeVisibleColumnRange(scrollLeft, columnWidths, containerWidth, columnOverscan);
+  }, [columnVirtualization, columnWidths, containerWidth, scrollLeft, columnOverscan]);
   return {
     virtualizer: isActive ? virtualizer : null,
     totalHeight,
     visibleRange: activeRange,
-    scrollToIndex
+    scrollToIndex,
+    columnRange,
+    onHorizontalScroll: columnVirtualization ? onHorizontalScroll : void 0
   };
 }
 function useListVirtualizer(opts) {
@@ -6177,12 +10154,26 @@ function useDataGridTableOrchestration(params) {
     density = "normal",
     pinnedColumns,
     currentPage = 1,
-    pageSize: propPageSize = 25
+    pageSize: propPageSize = 25,
+    showColumnLetters = false,
+    showNameBox = false,
+    onActiveCellChange
   } = props;
   const rowNumberOffset = hasRowNumbersCol ? (currentPage - 1) * propPageSize : 0;
   const headerRows = useMemo(() => buildHeaderRows(columns, visibleColumns), [columns, visibleColumns]);
   const allowOverflowX = !suppressHorizontalScroll && containerWidth > 0 && (minTableWidth > containerWidth || desiredTableWidth > containerWidth);
   const fitToContent = layoutMode === "content";
+  const onActiveCellChangeRef = useRef(onActiveCellChange);
+  onActiveCellChangeRef.current = onActiveCellChange;
+  useEffect(() => {
+    if (!onActiveCellChangeRef.current) return;
+    const ac = interaction.activeCell;
+    if (ac) {
+      onActiveCellChangeRef.current(formatCellReference(ac.columnIndex, rowNumberOffset + ac.rowIndex + 1));
+    } else {
+      onActiveCellChangeRef.current(null);
+    }
+  }, [interaction.activeCell, rowNumberOffset]);
   const { handleResizeStart, handleResizeDoubleClick, getColumnWidth } = useColumnResize({
     columnSizingOverrides,
     setColumnSizingOverrides
@@ -6197,13 +10188,28 @@ function useDataGridTableOrchestration(params) {
   });
   const virtualScrollEnabled = virtualScroll?.enabled === true;
   const virtualRowHeight = virtualScroll?.rowHeight ?? 36;
-  const { visibleRange } = useVirtualScroll({
+  const columnVirtualization = virtualScroll?.columns === true;
+  const unpinnedColumnWidths = useMemo(() => {
+    if (!columnVirtualization) return void 0;
+    const widths = [];
+    for (const col of visibleCols) {
+      const pin = pinnedColumns?.[col.columnId];
+      if (!pin) {
+        widths.push(getColumnWidth(col));
+      }
+    }
+    return widths;
+  }, [columnVirtualization, visibleCols, pinnedColumns, getColumnWidth]);
+  const { visibleRange, columnRange, onHorizontalScroll } = useVirtualScroll({
     totalRows: items.length,
     rowHeight: virtualRowHeight,
     enabled: virtualScrollEnabled,
     overscan: virtualScroll?.overscan,
     threshold: virtualScroll?.threshold,
-    containerRef: wrapperRef
+    containerRef: wrapperRef,
+    columnVirtualization,
+    columnWidths: unpinnedColumnWidths,
+    columnOverscan: virtualScroll?.columnOverscan
   });
   const editCallbacks = useMemo(
     () => ({ commitCellEdit, setEditingCell, setPendingEditorValue, cancelPopoverEdit }),
@@ -6259,6 +10265,8 @@ function useDataGridTableOrchestration(params) {
     virtualScrollEnabled,
     virtualRowHeight,
     visibleRange,
+    columnRange,
+    onHorizontalScroll,
     // Derived from props
     items,
     columns,
@@ -6285,6 +10293,8 @@ function useDataGridTableOrchestration(params) {
     headerRows,
     allowOverflowX,
     fitToContent,
+    showColumnLetters,
+    showNameBox,
     // Memoized callback groups
     editCallbacks,
     interactionHandlers,
@@ -6869,7 +10879,8 @@ var richSelectDropdownStyle = {
   background: "var(--ogrid-bg, #fff)",
   border: "1px solid var(--ogrid-border, rgba(0, 0, 0, 0.12))",
   zIndex: 10,
-  boxShadow: "var(--ogrid-shadow, 0 4px 16px rgba(0,0,0,0.2))"
+  boxShadow: "var(--ogrid-shadow, 0 4px 16px rgba(0,0,0,0.2))",
+  textAlign: "left"
 };
 var richSelectOptionStyle = {
   padding: "6px 8px",
@@ -6911,7 +10922,7 @@ var selectChevronStyle = {
 };
 function BaseInlineCellEditor(props) {
   const { value, column, editorType, onCommit, onCancel, renderCheckbox } = props;
-  const wrapperRef = React4.useRef(null);
+  const wrapperRef = React5.useRef(null);
   const { localValue, setLocalValue, handleKeyDown, handleBlur, commit, cancel } = useInlineCellEditorState({ value, editorType, onCommit, onCancel });
   const editorValues = column.cellEditorParams?.values ?? [];
   const editorFormatValue = column.cellEditorParams?.formatValue;
@@ -6928,8 +10939,8 @@ function BaseInlineCellEditor(props) {
     onCommit,
     onCancel
   });
-  const [fixedDropdownStyle, setFixedDropdownStyle] = React4.useState(null);
-  React4.useLayoutEffect(() => {
+  const [fixedDropdownStyle, setFixedDropdownStyle] = React5.useState(null);
+  React5.useLayoutEffect(() => {
     if (editorType !== "select" && editorType !== "richSelect") return;
     const wrapper = wrapperRef.current;
     if (!wrapper) return;
@@ -6947,17 +10958,25 @@ function BaseInlineCellEditor(props) {
       background: "var(--ogrid-bg, #fff)",
       border: "1px solid var(--ogrid-border, rgba(0, 0, 0, 0.12))",
       zIndex: 9999,
-      boxShadow: "var(--ogrid-shadow, 0 4px 16px rgba(0,0,0,0.2))"
+      boxShadow: "var(--ogrid-shadow, 0 4px 16px rgba(0,0,0,0.2))",
+      textAlign: "left"
     });
   }, [editorType]);
   const computedDropdownStyle = fixedDropdownStyle ?? richSelectDropdownStyle;
-  React4.useEffect(() => {
+  React5.useEffect(() => {
     const wrapper = wrapperRef.current;
     if (!wrapper) return;
     const input = wrapper.querySelector("input");
     if (input) {
       input.focus();
-      input.select();
+      if (editorType === "date") {
+        try {
+          input.showPicker();
+        } catch {
+        }
+      } else {
+        input.select();
+      }
     } else {
       wrapper.focus();
     }
@@ -7045,12 +11064,12 @@ function BaseInlineCellEditor(props) {
 var menuPositionStyle = (x, y) => ({ left: x, top: y });
 function GridContextMenu(props) {
   const { x, y, hasSelection, canUndo, canRedo, onClose, onCopy, onCut, onPaste, onSelectAll, onUndo, onRedo, classNames } = props;
-  const ref = React4.useRef(null);
-  const handlers = React4.useMemo(
+  const ref = React5.useRef(null);
+  const handlers = React5.useMemo(
     () => getContextMenuHandlers({ onCopy, onCut, onPaste, onSelectAll, onUndo, onRedo, onClose }),
     [onCopy, onCut, onPaste, onSelectAll, onUndo, onRedo, onClose]
   );
-  const isDisabled = React4.useCallback(
+  const isDisabled = React5.useCallback(
     (item) => {
       if (item.disabledWhenNoSelection && !hasSelection) return true;
       if (item.id === "undo" && !canUndo) return true;
@@ -7059,7 +11078,7 @@ function GridContextMenu(props) {
     },
     [hasSelection, canUndo, canRedo]
   );
-  React4.useEffect(() => {
+  React5.useEffect(() => {
     const handleClickOutside = (e) => {
       if (ref.current && !ref.current.contains(e.target)) onClose();
     };
@@ -7081,7 +11100,7 @@ function GridContextMenu(props) {
       role: "menu",
       style: menuPositionStyle(x, y),
       "aria-label": "Grid context menu",
-      children: GRID_CONTEXT_MENU_ITEMS.map((item) => /* @__PURE__ */ jsxs(React4.Fragment, { children: [
+      children: GRID_CONTEXT_MENU_ITEMS.map((item) => /* @__PURE__ */ jsxs(React5.Fragment, { children: [
         item.dividerBefore && /* @__PURE__ */ jsx("div", { className: classNames?.contextMenuDivider }),
         /* @__PURE__ */ jsxs(
           "button",
@@ -7242,9 +11261,9 @@ function BaseColumnHeaderMenu(props) {
     classNames,
     getPortalTarget
   } = props;
-  const [position, setPosition] = React4.useState(null);
-  const menuRef = React4.useRef(null);
-  React4.useEffect(() => {
+  const [position, setPosition] = React5.useState(null);
+  const menuRef = React5.useRef(null);
+  React5.useEffect(() => {
     if (!isOpen || !anchorElement) {
       setPosition(null);
       return;
@@ -7273,7 +11292,7 @@ function BaseColumnHeaderMenu(props) {
       document.removeEventListener("keydown", handleEscape);
     };
   }, [isOpen, anchorElement, onClose]);
-  const menuInput = React4.useMemo(
+  const menuInput = React5.useMemo(
     () => ({
       canPinLeft,
       canPinRight,
@@ -7284,8 +11303,8 @@ function BaseColumnHeaderMenu(props) {
     }),
     [canPinLeft, canPinRight, canUnpin, currentSort, isSortable, isResizable]
   );
-  const items = React4.useMemo(() => getColumnHeaderMenuItems(menuInput), [menuInput]);
-  const handlers = React4.useMemo(
+  const items = React5.useMemo(() => getColumnHeaderMenuItems(menuInput), [menuInput]);
+  const handlers = React5.useMemo(
     () => ({
       pinLeft: onPinLeft,
       pinRight: onPinRight,
@@ -7312,7 +11331,7 @@ function BaseColumnHeaderMenu(props) {
           left: position.left,
           zIndex: 1e3
         },
-        children: items.map((item, idx) => /* @__PURE__ */ jsxs(React4.Fragment, { children: [
+        children: items.map((item, idx) => /* @__PURE__ */ jsxs(React5.Fragment, { children: [
           /* @__PURE__ */ jsx(
             "button",
             {
@@ -7378,14 +11397,14 @@ function createOGrid(components) {
     );
   });
   OGridInner.displayName = "OGrid";
-  return React4.memo(OGridInner);
+  return React5.memo(OGridInner);
 }
 var DEFAULT_FALLBACK_STYLE = {
   color: "var(--ogrid-error, #d32f2f)",
   fontSize: "0.75rem",
   padding: "2px 4px"
 };
-var CellErrorBoundary = class extends React4.Component {
+var CellErrorBoundary = class extends React5.Component {
   constructor(props) {
     super(props);
     this.state = { hasError: false };
@@ -7561,4 +11580,4 @@ function renderFilterContent(filterType, state, options, isLoadingOptions, selec
   return null;
 }
 
-export { BaseColumnHeaderMenu, BaseDropIndicator, BaseEmptyState, BaseInlineCellEditor, BaseLoadingOverlay, CELL_PADDING, CHECKBOX_COLUMN_WIDTH, COLUMN_HEADER_MENU_ITEMS, CURSOR_CELL_STYLE, CellDescriptorCache, CellErrorBoundary, DEFAULT_MIN_COLUMN_WIDTH, DateFilterContent, EmptyState, GRID_BORDER_RADIUS, GRID_CONTEXT_MENU_ITEMS, GRID_ROOT_STYLE, GridContextMenu, MAX_PAGE_BUTTONS, MarchingAntsOverlay, NOOP3 as NOOP, OGridLayout, PAGE_SIZE_OPTIONS, POPOVER_ANCHOR_STYLE, PREVENT_DEFAULT, ROW_NUMBER_COLUMN_WIDTH, STOP_PROPAGATION, SideBar, StatusBar, UndoRedoStack, areGridRowPropsEqual, booleanParser, buildCsvHeader, buildCsvRows, buildHeaderRows, buildInlineEditorProps2 as buildInlineEditorProps, buildPopoverEditorProps2 as buildPopoverEditorProps, clampSelectionToBounds, computeAggregations, computeAutoScrollSpeed, computeTabNavigation, createOGrid, currencyParser, dateParser, deriveFilterOptionsFromData, editorInputStyle, editorWrapperStyle, emailParser, escapeCsvValue, exportToCsv, findCtrlArrowTarget, flattenColumns, formatCellValueForTsv, formatSelectionAsTsv, formatShortcut, getCellInteractionProps, getCellRenderDescriptor, getCellValue, getColumnHeaderFilterStateParams, getColumnHeaderMenuItems, getContextMenuHandlers, getDataGridStatusBarConfig, getDateFilterContentProps, getFilterField, getHeaderFilterConfig, getMultiSelectFilterFields, getPaginationViewModel, getStatusBarParts, isInSelectionRange, isRowInRange, mergeFilter, normalizeSelectionRange, numberParser, parseTsvClipboard, parseValue, processClientSideData, rangesEqual, renderFilterContent, resolveCellDisplayContent2 as resolveCellDisplayContent, resolveCellStyle2 as resolveCellStyle, richSelectDropdownStyle, richSelectNoMatchesStyle, richSelectOptionHighlightedStyle, richSelectOptionStyle, richSelectWrapperStyle, selectChevronStyle, selectDisplayStyle, selectEditorStyle, toUserLike, triggerCsvDownload, useActiveCell, useCellEditing, useCellSelection, useClipboard, useColumnChooserState, useColumnHeaderFilterState, useColumnMeta, useColumnReorder, useColumnResize, useContextMenu, useDataGridState, useDataGridTableOrchestration, useDateFilterState, useDebounce, useFillHandle, useFilterOptions, useInlineCellEditorState, useKeyboardNavigation, useLatestRef, useListVirtualizer, useMultiSelectFilterState, useOGrid, usePaginationControls, usePeopleFilterState, useRichSelectState, useRowSelection, useSelectState, useSideBarState, useTableLayout, useTextFilterState, useUndoRedo, useVirtualScroll };
+export { BaseColumnHeaderMenu, BaseDropIndicator, BaseEmptyState, BaseInlineCellEditor, BaseLoadingOverlay, CELL_PADDING, CHECKBOX_COLUMN_WIDTH, COLUMN_HEADER_MENU_ITEMS, CURSOR_CELL_STYLE, CellDescriptorCache, CellErrorBoundary, DEFAULT_MIN_COLUMN_WIDTH, DateFilterContent, EmptyState, GRID_BORDER_RADIUS, GRID_CONTEXT_MENU_ITEMS, GRID_ROOT_STYLE, GridContextMenu, MAX_PAGE_BUTTONS, MarchingAntsOverlay, NOOP3 as NOOP, OGridLayout, PAGE_SIZE_OPTIONS, POPOVER_ANCHOR_STYLE, PREVENT_DEFAULT, ROW_NUMBER_COLUMN_WIDTH, STOP_PROPAGATION, SideBar, StatusBar, UndoRedoStack, areGridRowPropsEqual, booleanParser, buildCsvHeader, buildCsvRows, buildHeaderRows, buildInlineEditorProps2 as buildInlineEditorProps, buildPopoverEditorProps2 as buildPopoverEditorProps, clampSelectionToBounds, computeAggregations, computeAutoScrollSpeed, computeTabNavigation, createOGrid, currencyParser, dateParser, deriveFilterOptionsFromData, editorInputStyle, editorWrapperStyle, emailParser, escapeCsvValue, exportToCsv, findCtrlArrowTarget, flattenColumns, formatCellReference, formatCellValueForTsv, formatSelectionAsTsv, formatShortcut, getCellInteractionProps, getCellRenderDescriptor, getCellValue, getColumnHeaderFilterStateParams, getColumnHeaderMenuItems, getContextMenuHandlers, getDataGridStatusBarConfig, getDateFilterContentProps, getFilterField, getHeaderFilterConfig, getMultiSelectFilterFields, getPaginationViewModel, getStatusBarParts, indexToColumnLetter, isInSelectionRange, isRowInRange, mergeFilter, normalizeSelectionRange, numberParser, parseTsvClipboard, parseValue, partitionColumnsForVirtualization, processClientSideData, rangesEqual, renderFilterContent, resolveCellDisplayContent2 as resolveCellDisplayContent, resolveCellStyle2 as resolveCellStyle, richSelectDropdownStyle, richSelectNoMatchesStyle, richSelectOptionHighlightedStyle, richSelectOptionStyle, richSelectWrapperStyle, selectChevronStyle, selectDisplayStyle, selectEditorStyle, toUserLike, triggerCsvDownload, useActiveCell, useCellEditing, useCellSelection, useClipboard, useColumnChooserState, useColumnHeaderFilterState, useColumnMeta, useColumnReorder, useColumnResize, useContextMenu, useDataGridState, useDataGridTableOrchestration, useDateFilterState, useDebounce, useFillHandle, useFilterOptions, useFormulaEngine, useInlineCellEditorState, useKeyboardNavigation, useLatestRef, useListVirtualizer, useMultiSelectFilterState, useOGrid, usePaginationControls, usePeopleFilterState, useRichSelectState, useRowSelection, useSelectState, useSideBarState, useTableLayout, useTextFilterState, useUndoRedo, useVirtualScroll };