@rowsncolumns/fast-formula-parser 6.2.44 → 6.2.45

package/dist/esm/index.js

@@ -53227,6 +53227,11 @@ class FormulaParser {
     );
     this.onRange = config.onRange;
     this.onCell = config.onCell;
+    // Observer of every cell / range the evaluation actually reads, with the
+    // cell being evaluated. `INDIRECT` / `OFFSET` targets only exist at run
+    // time, so this is how a host learns the dynamic precedents of a formula
+    // (the dependency parser cannot see them).
+    this.onReferenceResolved = config.onReferenceResolved;
     // Optional host callback reporting row visibility for SUBTOTAL:
     // ({sheet, row}) => {hiddenByFilter?: boolean, hiddenByUser?: boolean}
     this.onRowHidden = config.onRowHidden;
@@ -53376,18 +53381,36 @@ class FormulaParser {
         const bounds = this.onSpilledRange(ref);
         if (bounds instanceof FormulaError) return bounds;
         if (bounds && bounds.from && bounds.to) {
-          return this.onRange({
+          const spilled = {
             from: bounds.from,
             to: bounds.to,
             sheet: bounds.sheet ?? ref.sheet,
-          });
+          };
+          this.noteReferenceResolved("range", spilled, finalPosition);
+          return this.onRange(spilled);
         }
       }
       return FormulaError.REF;
     }
+    this.noteReferenceResolved("cell", ref, finalPosition);
     return this.onCell(ref);
   }
 
+  /**
+   * Tell the host which reference an evaluation is about to read.
+   * @param {"cell"|"range"} kind
+   * @param ref - the resolved reference (sheet already defaulted)
+   * @param position - the cell being evaluated, when known
+   */
+  noteReferenceResolved(kind, ref, position) {
+    if (typeof this.onReferenceResolved !== "function") return;
+    try {
+      this.onReferenceResolved({ kind, ref, position });
+    } catch {
+      // An observer must never break the evaluation.
+    }
+  }
+
   /**
    * Get values from the range reference.
    * @param ref
@@ -53402,6 +53425,7 @@ class FormulaParser {
     if (ref.sheetEnd != null) {
       return this.get3DRange(ref, true);
     }
+    this.noteReferenceResolved("range", ref, finalPosition);
     return this.onRange(ref);
   }
 
@@ -53438,6 +53462,11 @@ class FormulaParser {
     for (const sheet of sheets) {
       const { sheetEnd: _ignored, ...perSheet } = ref;
       perSheet.sheet = sheet;
+      this.noteReferenceResolved(
+        isRange ? "range" : "cell",
+        perSheet,
+        this.position,
+      );
       const value = isRange ? this.onRange(perSheet) : this.onCell(perSheet);
       if (value instanceof FormulaError) return value;
       if (Array.isArray(value)) {