@ricsam/formula-engine 0.2.2 → 0.2.4

package/dist/mjs/evaluator/range-evaluation-node.mjs

@@ -7,9 +7,9 @@ class RangeEvaluationNode extends FrontierDependencyManager {
   key;
   address;
   _result;
-  constructor(rangeKey, dependencyManager, workbookManager) {
+  constructor(rangeKey, dependencyManager, workbookManager, options) {
     const rangeAddress = keyToRangeAddress(rangeKey);
-    super(rangeAddress, workbookManager, dependencyManager);
+    super(rangeAddress, workbookManager, dependencyManager, options);
     this.rangeKey = rangeKey;
     this.address = rangeAddress;
     this.key = rangeKey;
@@ -28,6 +28,20 @@ class RangeEvaluationNode extends FrontierDependencyManager {
   canResolve() {
     return super.canResolve() && this._result.type !== "awaiting-evaluation";
   }
+  restoreResolvedSnapshot(options) {
+    super.restoreResolvedSnapshot({
+      dependencies: options.dependencies
+    });
+    this._result = options.result;
+  }
+  invalidate() {
+    super.invalidate();
+    this._result = {
+      type: "awaiting-evaluation",
+      waitingFor: this,
+      errAddress: this
+    };
+  }
   toJSON(visitor = new Set) {
     const hasVisited = visitor?.has(this.key);
     visitor?.add(this.key);
@@ -55,4 +69,4 @@ export {
   RangeEvaluationNode
 };
 
-//# debugId=E7418D30D9D7EAAD64756E2164756E21
+//# debugId=CB41D7681035F56A64756E2164756E21

package/dist/mjs/evaluator/range-evaluation-node.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/evaluator/range-evaluation-node.ts"],
   "sourcesContent": [
-    "import type { DependencyManager } from \"../core/managers/dependency-manager.mjs\";\nimport { FrontierDependencyManager } from \"../core/managers/frontier-dependency-manager.mjs\";\nimport type { WorkbookManager } from \"../core/managers/workbook-manager.mjs\";\nimport type { EvaluateAllCellsResult, RangeAddress } from \"../core/types.mjs\";\nimport { getRangeKey, keyToRangeAddress } from \"../core/utils.mjs\";\n\nexport class RangeEvaluationNode extends FrontierDependencyManager {\n  public key: string;\n  public address: RangeAddress;\n\n  private _result: EvaluateAllCellsResult;\n\n  constructor(\n    public rangeKey: string,\n    dependencyManager: DependencyManager,\n    workbookManager: WorkbookManager\n  ) {\n    const rangeAddress = keyToRangeAddress(rangeKey);\n    super(rangeAddress, workbookManager, dependencyManager);\n\n    this.address = rangeAddress;\n    this.key = rangeKey;\n    this._result = {\n      type: \"awaiting-evaluation\",\n      waitingFor: this,\n      errAddress: this,\n    };\n  }\n\n  setResult(result: EvaluateAllCellsResult): void {\n    this._result = result;\n  }\n\n  public get result(): EvaluateAllCellsResult {\n    return this._result;\n  }\n\n  public override canResolve(): boolean {\n    return super.canResolve() && this._result.type !== \"awaiting-evaluation\";\n  }\n\n  toJSON(visitor: Set<string> = new Set()): any {\n    const hasVisited = visitor?.has(this.key);\n    visitor?.add(this.key);\n    if (hasVisited) {\n      return {\n        key: this.key,\n        resolved: this.resolved,\n        cycle: true,\n        dependencies: [],\n        frontierDependencies: [],\n      };\n    }\n    return {\n      key: this.key,\n      resolved: this.resolved,\n      dependencies: Array.from(this.getDependencies()).map((node) =>\n        node.toJSON(visitor)\n      ),\n      frontierDependencies: Array.from(this.getFrontierDependencies()).map(\n        (node) => node.toJSON(visitor)\n      ),\n    };\n  }\n\n  public override toString(): string {\n    return getRangeKey(this.address.range);\n  }\n}\n"
+    "import type { DependencyManager } from \"../core/managers/dependency-manager.mjs\";\nimport { FrontierDependencyManager } from \"../core/managers/frontier-dependency-manager.mjs\";\nimport type { WorkbookManager } from \"../core/managers/workbook-manager.mjs\";\nimport type { EvaluateAllCellsResult, RangeAddress } from \"../core/types.mjs\";\nimport { getRangeKey, keyToRangeAddress } from \"../core/utils.mjs\";\n\nexport class RangeEvaluationNode extends FrontierDependencyManager {\n  public key: string;\n  public address: RangeAddress;\n\n  private _result: EvaluateAllCellsResult;\n\n  constructor(\n    public rangeKey: string,\n    dependencyManager: DependencyManager,\n    workbookManager: WorkbookManager,\n    options?: { skipInitialBuild?: boolean }\n  ) {\n    const rangeAddress = keyToRangeAddress(rangeKey);\n    super(rangeAddress, workbookManager, dependencyManager, options);\n\n    this.address = rangeAddress;\n    this.key = rangeKey;\n    this._result = {\n      type: \"awaiting-evaluation\",\n      waitingFor: this,\n      errAddress: this,\n    };\n  }\n\n  setResult(result: EvaluateAllCellsResult): void {\n    this._result = result;\n  }\n\n  public get result(): EvaluateAllCellsResult {\n    return this._result;\n  }\n\n  public override canResolve(): boolean {\n    return super.canResolve() && this._result.type !== \"awaiting-evaluation\";\n  }\n\n  public override restoreResolvedSnapshot(options: {\n    dependencies: Set<import(\"../core/managers/dependency-node.mjs\").DependencyNode>;\n    result: EvaluateAllCellsResult;\n  }) {\n    super.restoreResolvedSnapshot({\n      dependencies: options.dependencies,\n    });\n    this._result = options.result;\n  }\n\n  public override invalidate() {\n    super.invalidate();\n    this._result = {\n      type: \"awaiting-evaluation\",\n      waitingFor: this,\n      errAddress: this,\n    };\n  }\n\n  toJSON(visitor: Set<string> = new Set()): any {\n    const hasVisited = visitor?.has(this.key);\n    visitor?.add(this.key);\n    if (hasVisited) {\n      return {\n        key: this.key,\n        resolved: this.resolved,\n        cycle: true,\n        dependencies: [],\n        frontierDependencies: [],\n      };\n    }\n    return {\n      key: this.key,\n      resolved: this.resolved,\n      dependencies: Array.from(this.getDependencies()).map((node) =>\n        node.toJSON(visitor)\n      ),\n      frontierDependencies: Array.from(this.getFrontierDependencies()).map(\n        (node) => node.toJSON(visitor)\n      ),\n    };\n  }\n\n  public override toString(): string {\n    return getRangeKey(this.address.range);\n  }\n}\n"
   ],
-  "mappings": ";AACA;AAGA;AAAA;AAEO,MAAM,4BAA4B,0BAA0B;AAAA,EAOxD;AAAA,EANF;AAAA,EACA;AAAA,EAEC;AAAA,EAER,WAAW,CACF,UACP,mBACA,iBACA;AAAA,IACA,MAAM,eAAe,kBAAkB,QAAQ;AAAA,IAC/C,MAAM,cAAc,iBAAiB,iBAAiB;AAAA,IAL/C;AAAA,IAOP,KAAK,UAAU;AAAA,IACf,KAAK,MAAM;AAAA,IACX,KAAK,UAAU;AAAA,MACb,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,YAAY;AAAA,IACd;AAAA;AAAA,EAGF,SAAS,CAAC,QAAsC;AAAA,IAC9C,KAAK,UAAU;AAAA;AAAA,MAGN,MAAM,GAA2B;AAAA,IAC1C,OAAO,KAAK;AAAA;AAAA,EAGE,UAAU,GAAY;AAAA,IACpC,OAAO,MAAM,WAAW,KAAK,KAAK,QAAQ,SAAS;AAAA;AAAA,EAGrD,MAAM,CAAC,UAAuB,IAAI,KAAY;AAAA,IAC5C,MAAM,aAAa,SAAS,IAAI,KAAK,GAAG;AAAA,IACxC,SAAS,IAAI,KAAK,GAAG;AAAA,IACrB,IAAI,YAAY;AAAA,MACd,OAAO;AAAA,QACL,KAAK,KAAK;AAAA,QACV,UAAU,KAAK;AAAA,QACf,OAAO;AAAA,QACP,cAAc,CAAC;AAAA,QACf,sBAAsB,CAAC;AAAA,MACzB;AAAA,IACF;AAAA,IACA,OAAO;AAAA,MACL,KAAK,KAAK;AAAA,MACV,UAAU,KAAK;AAAA,MACf,cAAc,MAAM,KAAK,KAAK,gBAAgB,CAAC,EAAE,IAAI,CAAC,SACpD,KAAK,OAAO,OAAO,CACrB;AAAA,MACA,sBAAsB,MAAM,KAAK,KAAK,wBAAwB,CAAC,EAAE,IAC/D,CAAC,SAAS,KAAK,OAAO,OAAO,CAC/B;AAAA,IACF;AAAA;AAAA,EAGc,QAAQ,GAAW;AAAA,IACjC,OAAO,YAAY,KAAK,QAAQ,KAAK;AAAA;AAEzC;",
-  "debugId": "E7418D30D9D7EAAD64756E2164756E21",
+  "mappings": ";AACA;AAGA;AAAA;AAEO,MAAM,4BAA4B,0BAA0B;AAAA,EAOxD;AAAA,EANF;AAAA,EACA;AAAA,EAEC;AAAA,EAER,WAAW,CACF,UACP,mBACA,iBACA,SACA;AAAA,IACA,MAAM,eAAe,kBAAkB,QAAQ;AAAA,IAC/C,MAAM,cAAc,iBAAiB,mBAAmB,OAAO;AAAA,IANxD;AAAA,IAQP,KAAK,UAAU;AAAA,IACf,KAAK,MAAM;AAAA,IACX,KAAK,UAAU;AAAA,MACb,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,YAAY;AAAA,IACd;AAAA;AAAA,EAGF,SAAS,CAAC,QAAsC;AAAA,IAC9C,KAAK,UAAU;AAAA;AAAA,MAGN,MAAM,GAA2B;AAAA,IAC1C,OAAO,KAAK;AAAA;AAAA,EAGE,UAAU,GAAY;AAAA,IACpC,OAAO,MAAM,WAAW,KAAK,KAAK,QAAQ,SAAS;AAAA;AAAA,EAGrC,uBAAuB,CAAC,SAGrC;AAAA,IACD,MAAM,wBAAwB;AAAA,MAC5B,cAAc,QAAQ;AAAA,IACxB,CAAC;AAAA,IACD,KAAK,UAAU,QAAQ;AAAA;AAAA,EAGT,UAAU,GAAG;AAAA,IAC3B,MAAM,WAAW;AAAA,IACjB,KAAK,UAAU;AAAA,MACb,MAAM;AAAA,MACN,YAAY;AAAA,MACZ,YAAY;AAAA,IACd;AAAA;AAAA,EAGF,MAAM,CAAC,UAAuB,IAAI,KAAY;AAAA,IAC5C,MAAM,aAAa,SAAS,IAAI,KAAK,GAAG;AAAA,IACxC,SAAS,IAAI,KAAK,GAAG;AAAA,IACrB,IAAI,YAAY;AAAA,MACd,OAAO;AAAA,QACL,KAAK,KAAK;AAAA,QACV,UAAU,KAAK;AAAA,QACf,OAAO;AAAA,QACP,cAAc,CAAC;AAAA,QACf,sBAAsB,CAAC;AAAA,MACzB;AAAA,IACF;AAAA,IACA,OAAO;AAAA,MACL,KAAK,KAAK;AAAA,MACV,UAAU,KAAK;AAAA,MACf,cAAc,MAAM,KAAK,KAAK,gBAAgB,CAAC,EAAE,IAAI,CAAC,SACpD,KAAK,OAAO,OAAO,CACrB;AAAA,MACA,sBAAsB,MAAM,KAAK,KAAK,wBAAwB,CAAC,EAAE,IAC/D,CAAC,SAAS,KAAK,OAAO,OAAO,CAC/B;AAAA,IACF;AAAA;AAAA,EAGc,QAAQ,GAAW;AAAA,IACjC,OAAO,YAAY,KAAK,QAAQ,KAAK;AAAA;AAEzC;",
+  "debugId": "CB41D7681035F56A64756E2164756E21",
   "names": []
 }

package/dist/mjs/functions/lookup/match/match.mjs

@@ -26,7 +26,8 @@ function matchOperation(lookupValue, lookupArray, matchType, context, isHorizont
     if (value.result.type === "value") {
       if (matchType === 0) {
         const arrayValue = value.result.result;
-        if (arrayValue.type === lookupValue.type && arrayValue.value === lookupValue.value) {
+        const isMatch = arrayValue.type === lookupValue.type && (arrayValue.type === "string" && lookupValue.type === "string" ? arrayValue.value.toLowerCase() === lookupValue.value.toLowerCase() : arrayValue.value === lookupValue.value);
+        if (isMatch) {
           const position = isHorizontal ? value.relativePos.x + 1 : value.relativePos.y + 1;
           return {
             type: "value",
@@ -137,4 +138,4 @@ export {
   MATCH
 };
 
-//# debugId=BA7EA11C6CC1796964756E2164756E21
+//# debugId=E8B4E1E3709915CB64756E2164756E21

package/dist/mjs/functions/lookup/match/match.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../../src/functions/lookup/match/match.ts"],
   "sourcesContent": [
-    "import {\n  FormulaError,\n  type CellValue,\n  type EvaluateAllCellsResult,\n  type FunctionDefinition,\n  type FunctionEvaluationResult,\n} from \"../../../core/types.mjs\";\nimport type { EvaluationContext } from \"../../../evaluator/evaluation-context.mjs\";\n\n/**\n * MATCH function - Returns the position of a value in an array\n * MATCH(lookup_value, lookup_array, [match_type])\n * match_type: 1 = less than or equal (default), 0 = exact match, -1 = greater than or equal\n *\n * STRICT TYPE CHECKING:\n * - lookup_value: string or number only\n * - lookup_array: array of strings or numbers only\n * - match_type: number only (must be -1, 0, or 1)\n */\n\n// Helper function to perform MATCH operation\nfunction matchOperation(\n  lookupValue: CellValue,\n  lookupArray: EvaluateAllCellsResult,\n  matchType: number,\n  context: EvaluationContext,\n  isHorizontal: boolean\n): FunctionEvaluationResult {\n  // Strict type checking for lookup_value\n  if (lookupValue.type !== \"string\" && lookupValue.type !== \"number\") {\n    return {\n      type: \"error\",\n      err: FormulaError.VALUE,\n      message: `MATCH lookup_value must be string or number, got ${lookupValue.type}`,\n      errAddress: context.dependencyNode,\n    };\n  }\n\n  // Validate match_type\n  if (matchType !== -1 && matchType !== 0 && matchType !== 1) {\n    return {\n      type: \"error\",\n      err: FormulaError.VALUE,\n      message: `MATCH match_type must be -1, 0, or 1, got ${matchType}`,\n      errAddress: context.dependencyNode,\n    };\n  }\n  if (\n    lookupArray.type === \"awaiting-evaluation\" ||\n    lookupArray.type === \"error\"\n  ) {\n    return lookupArray;\n  }\n\n  for (const value of lookupArray.values) {\n    if (value.result.type === \"value\") {\n      if (matchType === 0) {\n        // Exact match\n        const arrayValue = value.result.result;\n\n        if (\n          arrayValue.type === lookupValue.type &&\n          arrayValue.value === lookupValue.value\n        ) {\n          // For horizontal arrays (single row), use x position (column index)\n          // For vertical arrays (single/multiple columns), use y position (row index)\n          const position = isHorizontal\n            ? value.relativePos.x + 1\n            : value.relativePos.y + 1;\n\n          return {\n            type: \"value\",\n            result: { type: \"number\", value: position },\n          }; // 1-based index\n        }\n      } else {\n        // Approximate match (1 or -1) - requires sorted array\n        // For now, throw an error until we add sorting validation\n        // TODO: Add proper approximate match logic with sorted array validation\n        throw new Error(\"MATCH: approximate match not fully implemented\");\n      }\n    }\n  }\n\n  return {\n    type: \"error\",\n    err: FormulaError.NA,\n    message: \"MATCH: lookup_value not found in lookup_array\",\n    errAddress: context.dependencyNode,\n  };\n}\n\nexport const MATCH: FunctionDefinition = {\n  name: \"MATCH\",\n  evaluate: function (node, context): FunctionEvaluationResult {\n    if (node.args.length < 2 || node.args.length > 3) {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"MATCH function takes 2 or 3 arguments\",\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Evaluate lookup_value\n    const lookupValueResult = this.evaluateNode(node.args[0]!, context);\n    if (\n      lookupValueResult.type === \"error\" ||\n      lookupValueResult.type === \"awaiting-evaluation\"\n    ) {\n      return lookupValueResult;\n    }\n\n    // Evaluate lookup_array\n    const lookupArrayResult = this.evaluateNode(node.args[1]!, context);\n    if (\n      lookupArrayResult.type === \"error\" ||\n      lookupArrayResult.type === \"awaiting-evaluation\"\n    ) {\n      return lookupArrayResult;\n    }\n\n    // Evaluate match_type (optional, defaults to 1)\n    let matchTypeResult: FunctionEvaluationResult = {\n      type: \"value\",\n      result: { type: \"number\", value: 1 },\n    };\n\n    if (node.args[2]) {\n      matchTypeResult = this.evaluateNode(node.args[2], context);\n      if (\n        matchTypeResult.type === \"error\" ||\n        matchTypeResult.type === \"awaiting-evaluation\"\n      ) {\n        return matchTypeResult;\n      }\n    }\n\n    // Handle spilled arrays for lookup_value and match_type (not lookup_array which is expected to be a range)\n    if (\n      lookupValueResult.type === \"spilled-values\" ||\n      matchTypeResult.type === \"spilled-values\"\n    ) {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"MATCH: Spilled array arguments not yet implemented\",\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Strict type checking for match_type\n    if (matchTypeResult.result.type !== \"number\") {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: `MATCH match_type must be number, got ${matchTypeResult.result.type}`,\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Extract lookup_array values\n    let lookupArray: EvaluateAllCellsResult = {\n      type: \"awaiting-evaluation\",\n      waitingFor: context.dependencyNode,\n      errAddress: context.dependencyNode,\n    };\n    let isHorizontal = false;\n\n    // Handle direct range arguments (like A:A) before extracting lookup_array values\n\n    // Extract lookup_array values for non-infinite ranges\n    if (lookupArrayResult.type === \"value\") {\n      // Single value case - treat as array with one element\n      lookupArray = {\n        type: \"values\",\n        values: [{ result: lookupArrayResult, relativePos: { x: 0, y: 0 } }],\n      };\n      isHorizontal = false; // Single value, treat as vertical\n    } else if (lookupArrayResult.type === \"spilled-values\") {\n      // Validate that lookup_array is 1D (either single row OR single column)\n      const spillArea = lookupArrayResult.spillArea(context.cellAddress);\n      const startRow = spillArea.start.row;\n      const endRow = spillArea.end.row;\n      const startCol = spillArea.start.col;\n      const endCol = spillArea.end.col;\n\n      // Check if it's a single row (horizontal)\n      const isSingleRow = endRow.type === \"number\" && startRow === endRow.value;\n\n      // Check if it's a single column (vertical)\n      const isSingleCol = endCol.type === \"number\" && startCol === endCol.value;\n\n      // MATCH requires a 1D array - either single row OR single column, not both or neither\n      if (!isSingleRow && !isSingleCol) {\n        return {\n          type: \"error\",\n          err: FormulaError.VALUE,\n          message:\n            \"MATCH lookup_array must be a single row or single column (1D array)\",\n          errAddress: context.dependencyNode,\n        };\n      }\n\n      // Cannot be both single row AND single column (that would be a single cell, which is handled)\n      if (isSingleRow && isSingleCol) {\n        // This is actually a single cell, which is fine\n        isHorizontal = false; // Treat single cell as vertical\n      } else {\n        // Horizontal if it's a single row\n        isHorizontal = isSingleRow;\n      }\n\n      // Extract values from spilled array\n      lookupArray = lookupArrayResult.evaluateAllCells.call(this, {\n        context,\n        evaluate: lookupArrayResult.evaluate,\n        origin: context.cellAddress,\n        lookupOrder: \"col-major\",\n      });\n    }\n\n    // Perform MATCH operation\n    return matchOperation(\n      lookupValueResult.result,\n      lookupArray,\n      Math.floor(matchTypeResult.result.value), // Floor to handle decimal inputs\n      context,\n      isHorizontal\n    );\n  },\n};\n"
+    "import {\n  FormulaError,\n  type CellValue,\n  type EvaluateAllCellsResult,\n  type FunctionDefinition,\n  type FunctionEvaluationResult,\n} from \"../../../core/types.mjs\";\nimport type { EvaluationContext } from \"../../../evaluator/evaluation-context.mjs\";\n\n/**\n * MATCH function - Returns the position of a value in an array\n * MATCH(lookup_value, lookup_array, [match_type])\n * match_type: 1 = less than or equal (default), 0 = exact match, -1 = greater than or equal\n *\n * STRICT TYPE CHECKING:\n * - lookup_value: string or number only\n * - lookup_array: array of strings or numbers only\n * - match_type: number only (must be -1, 0, or 1)\n */\n\n// Helper function to perform MATCH operation\nfunction matchOperation(\n  lookupValue: CellValue,\n  lookupArray: EvaluateAllCellsResult,\n  matchType: number,\n  context: EvaluationContext,\n  isHorizontal: boolean\n): FunctionEvaluationResult {\n  // Strict type checking for lookup_value\n  if (lookupValue.type !== \"string\" && lookupValue.type !== \"number\") {\n    return {\n      type: \"error\",\n      err: FormulaError.VALUE,\n      message: `MATCH lookup_value must be string or number, got ${lookupValue.type}`,\n      errAddress: context.dependencyNode,\n    };\n  }\n\n  // Validate match_type\n  if (matchType !== -1 && matchType !== 0 && matchType !== 1) {\n    return {\n      type: \"error\",\n      err: FormulaError.VALUE,\n      message: `MATCH match_type must be -1, 0, or 1, got ${matchType}`,\n      errAddress: context.dependencyNode,\n    };\n  }\n  if (\n    lookupArray.type === \"awaiting-evaluation\" ||\n    lookupArray.type === \"error\"\n  ) {\n    return lookupArray;\n  }\n\n  for (const value of lookupArray.values) {\n    if (value.result.type === \"value\") {\n      if (matchType === 0) {\n        // Exact match (case-insensitive for strings, matching Excel behavior)\n        const arrayValue = value.result.result;\n\n        const isMatch =\n          arrayValue.type === lookupValue.type &&\n          (arrayValue.type === \"string\" && lookupValue.type === \"string\"\n            ? arrayValue.value.toLowerCase() === lookupValue.value.toLowerCase()\n            : arrayValue.value === lookupValue.value);\n\n        if (isMatch) {\n          // For horizontal arrays (single row), use x position (column index)\n          // For vertical arrays (single/multiple columns), use y position (row index)\n          const position = isHorizontal\n            ? value.relativePos.x + 1\n            : value.relativePos.y + 1;\n\n          return {\n            type: \"value\",\n            result: { type: \"number\", value: position },\n          }; // 1-based index\n        }\n      } else {\n        // Approximate match (1 or -1) - requires sorted array\n        // For now, throw an error until we add sorting validation\n        // TODO: Add proper approximate match logic with sorted array validation\n        throw new Error(\"MATCH: approximate match not fully implemented\");\n      }\n    }\n  }\n\n  return {\n    type: \"error\",\n    err: FormulaError.NA,\n    message: \"MATCH: lookup_value not found in lookup_array\",\n    errAddress: context.dependencyNode,\n  };\n}\n\nexport const MATCH: FunctionDefinition = {\n  name: \"MATCH\",\n  evaluate: function (node, context): FunctionEvaluationResult {\n    if (node.args.length < 2 || node.args.length > 3) {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"MATCH function takes 2 or 3 arguments\",\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Evaluate lookup_value\n    const lookupValueResult = this.evaluateNode(node.args[0]!, context);\n    if (\n      lookupValueResult.type === \"error\" ||\n      lookupValueResult.type === \"awaiting-evaluation\"\n    ) {\n      return lookupValueResult;\n    }\n\n    // Evaluate lookup_array\n    const lookupArrayResult = this.evaluateNode(node.args[1]!, context);\n    if (\n      lookupArrayResult.type === \"error\" ||\n      lookupArrayResult.type === \"awaiting-evaluation\"\n    ) {\n      return lookupArrayResult;\n    }\n\n    // Evaluate match_type (optional, defaults to 1)\n    let matchTypeResult: FunctionEvaluationResult = {\n      type: \"value\",\n      result: { type: \"number\", value: 1 },\n    };\n\n    if (node.args[2]) {\n      matchTypeResult = this.evaluateNode(node.args[2], context);\n      if (\n        matchTypeResult.type === \"error\" ||\n        matchTypeResult.type === \"awaiting-evaluation\"\n      ) {\n        return matchTypeResult;\n      }\n    }\n\n    // Handle spilled arrays for lookup_value and match_type (not lookup_array which is expected to be a range)\n    if (\n      lookupValueResult.type === \"spilled-values\" ||\n      matchTypeResult.type === \"spilled-values\"\n    ) {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"MATCH: Spilled array arguments not yet implemented\",\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Strict type checking for match_type\n    if (matchTypeResult.result.type !== \"number\") {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: `MATCH match_type must be number, got ${matchTypeResult.result.type}`,\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Extract lookup_array values\n    let lookupArray: EvaluateAllCellsResult = {\n      type: \"awaiting-evaluation\",\n      waitingFor: context.dependencyNode,\n      errAddress: context.dependencyNode,\n    };\n    let isHorizontal = false;\n\n    // Handle direct range arguments (like A:A) before extracting lookup_array values\n\n    // Extract lookup_array values for non-infinite ranges\n    if (lookupArrayResult.type === \"value\") {\n      // Single value case - treat as array with one element\n      lookupArray = {\n        type: \"values\",\n        values: [{ result: lookupArrayResult, relativePos: { x: 0, y: 0 } }],\n      };\n      isHorizontal = false; // Single value, treat as vertical\n    } else if (lookupArrayResult.type === \"spilled-values\") {\n      // Validate that lookup_array is 1D (either single row OR single column)\n      const spillArea = lookupArrayResult.spillArea(context.cellAddress);\n      const startRow = spillArea.start.row;\n      const endRow = spillArea.end.row;\n      const startCol = spillArea.start.col;\n      const endCol = spillArea.end.col;\n\n      // Check if it's a single row (horizontal)\n      const isSingleRow = endRow.type === \"number\" && startRow === endRow.value;\n\n      // Check if it's a single column (vertical)\n      const isSingleCol = endCol.type === \"number\" && startCol === endCol.value;\n\n      // MATCH requires a 1D array - either single row OR single column, not both or neither\n      if (!isSingleRow && !isSingleCol) {\n        return {\n          type: \"error\",\n          err: FormulaError.VALUE,\n          message:\n            \"MATCH lookup_array must be a single row or single column (1D array)\",\n          errAddress: context.dependencyNode,\n        };\n      }\n\n      // Cannot be both single row AND single column (that would be a single cell, which is handled)\n      if (isSingleRow && isSingleCol) {\n        // This is actually a single cell, which is fine\n        isHorizontal = false; // Treat single cell as vertical\n      } else {\n        // Horizontal if it's a single row\n        isHorizontal = isSingleRow;\n      }\n\n      // Extract values from spilled array\n      lookupArray = lookupArrayResult.evaluateAllCells.call(this, {\n        context,\n        evaluate: lookupArrayResult.evaluate,\n        origin: context.cellAddress,\n        lookupOrder: \"col-major\",\n      });\n    }\n\n    // Perform MATCH operation\n    return matchOperation(\n      lookupValueResult.result,\n      lookupArray,\n      Math.floor(matchTypeResult.result.value), // Floor to handle decimal inputs\n      context,\n      isHorizontal\n    );\n  },\n};\n"
   ],
-  "mappings": "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",
-  "debugId": "BA7EA11C6CC1796964756E2164756E21",
+  "mappings": "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",
+  "debugId": "E8B4E1E3709915CB64756E2164756E21",
   "names": []
 }

package/dist/mjs/functions/text/concatenate/concatenate.mjs

@@ -26,6 +26,8 @@ function coerceToString(result, context) {
       }
     case "boolean":
       return result.result.value ? "TRUE" : "FALSE";
+    case "infinity":
+      return result.result.sign === "positive" ? "INFINITY" : "-INFINITY";
     default:
       return {
         type: "error",
@@ -136,4 +138,4 @@ export {
   CONCATENATE
 };
 
-//# debugId=51EDA2D25EB87B1F64756E2164756E21
+//# debugId=E486EB6FD50D339A64756E2164756E21

package/dist/mjs/functions/text/concatenate/concatenate.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../../src/functions/text/concatenate/concatenate.ts"],
   "sourcesContent": [
-    "import {\n  FormulaError,\n  type FunctionDefinition,\n  type FunctionEvaluationResult,\n  type CellString,\n  type CellAddress,\n  type SpreadsheetRange,\n  type SpilledValuesEvaluationResult,\n  type ErrorEvaluationResult,\n  type SingleEvaluationResult,\n} from \"../../../core/types.mjs\";\nimport { FormulaEvaluator } from \"../../../evaluator/formula-evaluator.mjs\";\nimport type { FunctionNode } from \"../../../parser/ast.mjs\";\nimport type { EvaluationContext } from \"../../../evaluator/evaluation-context.mjs\";\n\n/**\n * CONCATENATE function - Joins several text strings into one text string\n *\n * Usage: CONCATENATE(text1, text2, ...)\n *\n * text1, text2, ...: Text strings to be joined together.\n *\n * Example: CONCATENATE(\"Hello\", \" \", \"World\") returns \"Hello World\"\n *\n * Note:\n * - Takes 1 or more arguments\n * - Supports type coercion: strings, numbers, and booleans are converted to strings\n * - Numbers: converted to string representation (123 -> \"123\", Infinity -> \"INFINITY\")\n * - Booleans: TRUE -> \"TRUE\", FALSE -> \"FALSE\"\n * - Supports dynamic arrays (spilled values) for arguments\n * - If any argument is a spilled value, the result will be spilled\n */\n\n/**\n * Helper function to convert a cell value to string with type coercion\n */\nfunction coerceToString(\n  result: FunctionEvaluationResult,\n  context: EvaluationContext\n): string | ErrorEvaluationResult {\n  if (result.type !== \"value\") {\n    return {\n      type: \"error\",\n      err: FormulaError.VALUE,\n      message: \"Invalid argument type\",\n      errAddress: context.dependencyNode,\n    };\n  }\n\n  switch (result.result.type) {\n    case \"string\":\n      return result.result.value;\n    case \"number\":\n      // Convert number to string\n      if (result.result.value === Infinity) {\n        return \"INFINITY\";\n      } else if (result.result.value === -Infinity) {\n        return \"-INFINITY\";\n      } else if (isNaN(result.result.value)) {\n        return \"NaN\";\n      } else {\n        return result.result.value.toString();\n      }\n    case \"boolean\":\n      // Convert boolean to string\n      return result.result.value ? \"TRUE\" : \"FALSE\";\n    default:\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"Cannot convert argument to string\",\n        errAddress: context.dependencyNode,\n      };\n  }\n}\n\n/**\n * Helper function to perform CONCATENATE operation on evaluated arguments\n */\nfunction concatenateOperation(\n  textResults: FunctionEvaluationResult[],\n  context: EvaluationContext\n): { type: \"value\"; result: CellString } | ErrorEvaluationResult {\n  let result = \"\";\n  for (const textResult of textResults) {\n    const stringValue = coerceToString(textResult, context);\n    if (typeof stringValue === \"object\" && stringValue.type === \"error\") {\n      return stringValue;\n    }\n    result += stringValue;\n  }\n  return { type: \"value\", result: { type: \"string\", value: result } };\n}\n\n/**\n * Helper for creating spilled-values result for CONCATENATE function\n */\nfunction createConcatenateSpilledResult(\n  this: FormulaEvaluator,\n  {\n    textResults,\n    context,\n  }: {\n    textResults: FunctionEvaluationResult[];\n    context: EvaluationContext;\n  }\n): SpilledValuesEvaluationResult | ErrorEvaluationResult {\n  const spilledResults = textResults.filter(\n    (result) => result.type === \"spilled-values\"\n  );\n\n  if (spilledResults.length === 0) {\n    throw new Error(\n      \"createConcatenateSpilledResult called without spilled values\"\n    );\n  }\n\n  return {\n    type: \"spilled-values\",\n    spillArea: (origin: CellAddress): SpreadsheetRange => {\n      // Calculate spill area (union of all spilled ranges)\n      let spillArea: SpreadsheetRange | undefined;\n\n      for (const result of textResults) {\n        if (result.type === \"spilled-values\") {\n          const currentSpillArea = result.spillArea(origin);\n          if (!spillArea) {\n            spillArea = currentSpillArea;\n          } else {\n            spillArea = this.unionRanges(\n              this.projectRange(spillArea, origin),\n              this.projectRange(currentSpillArea, origin)\n            );\n          }\n        }\n      }\n\n      if (!spillArea) {\n        throw new Error(\"No spilled values found\");\n      }\n      return spillArea;\n    },\n    source: \"CONCATENATE with spilled values\",\n    evaluate: (spilledCell, evalContext): SingleEvaluationResult => {\n      // Evaluate all arguments at this spilled position\n      const spilledTextResults: FunctionEvaluationResult[] = [];\n\n      for (const textResult of textResults) {\n        if (textResult.type === \"spilled-values\") {\n          const spillResult = textResult.evaluate(spilledCell, evalContext);\n          if (spillResult === undefined) {\n            return {\n              type: \"error\",\n              err: FormulaError.REF,\n              message: \"The spilled results have not been evaluated\",\n              errAddress: context.dependencyNode,\n            };\n          }\n          if (spillResult.type === \"error\") {\n            return spillResult;\n          }\n          spilledTextResults.push(spillResult);\n        } else {\n          spilledTextResults.push(textResult);\n        }\n      }\n\n      return concatenateOperation(spilledTextResults, context);\n    },\n    evaluateAllCells: (intersectingRange) => {\n      throw new Error(\n        \"WIP: evaluateAllCells for CONCATENATE is not implemented\"\n      );\n    },\n  };\n}\n\n/**\n * CONCATENATE function implementation\n */\nexport const CONCATENATE: FunctionDefinition = {\n  name: \"CONCATENATE\",\n  evaluate: function (\n    node: FunctionNode,\n    context: EvaluationContext\n  ): FunctionEvaluationResult {\n    if (node.args.length < 1) {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"CONCATENATE function requires at least 1 argument\",\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Evaluate all arguments\n    const textResults: FunctionEvaluationResult[] = [];\n    for (const arg of node.args) {\n      const result = this.evaluateNode(arg, context);\n      if (result.type === \"error\" || result.type === \"awaiting-evaluation\") {\n        return result;\n      }\n      textResults.push(result);\n    }\n\n    // Check if any arguments are spilled values\n    const hasSpilledValues = textResults.some(\n      (result) => result.type === \"spilled-values\"\n    );\n\n    if (hasSpilledValues) {\n      return createConcatenateSpilledResult.call(this, {\n        textResults,\n        context,\n      });\n    }\n\n    // All arguments are single values - type coercion will be handled in concatenateOperation\n\n    // Perform concatenation\n    return concatenateOperation(textResults, context);\n  },\n  aliases: [\"CONCAT\"],\n};\n"
+    "import {\n  FormulaError,\n  type FunctionDefinition,\n  type FunctionEvaluationResult,\n  type CellString,\n  type CellAddress,\n  type SpreadsheetRange,\n  type SpilledValuesEvaluationResult,\n  type ErrorEvaluationResult,\n  type SingleEvaluationResult,\n} from \"../../../core/types.mjs\";\nimport { FormulaEvaluator } from \"../../../evaluator/formula-evaluator.mjs\";\nimport type { FunctionNode } from \"../../../parser/ast.mjs\";\nimport type { EvaluationContext } from \"../../../evaluator/evaluation-context.mjs\";\n\n/**\n * CONCATENATE function - Joins several text strings into one text string\n *\n * Usage: CONCATENATE(text1, text2, ...)\n *\n * text1, text2, ...: Text strings to be joined together.\n *\n * Example: CONCATENATE(\"Hello\", \" \", \"World\") returns \"Hello World\"\n *\n * Note:\n * - Takes 1 or more arguments\n * - Supports type coercion: strings, numbers, and booleans are converted to strings\n * - Numbers: converted to string representation (123 -> \"123\", Infinity -> \"INFINITY\")\n * - Booleans: TRUE -> \"TRUE\", FALSE -> \"FALSE\"\n * - Supports dynamic arrays (spilled values) for arguments\n * - If any argument is a spilled value, the result will be spilled\n */\n\n/**\n * Helper function to convert a cell value to string with type coercion\n */\nfunction coerceToString(\n  result: FunctionEvaluationResult,\n  context: EvaluationContext\n): string | ErrorEvaluationResult {\n  if (result.type !== \"value\") {\n    return {\n      type: \"error\",\n      err: FormulaError.VALUE,\n      message: \"Invalid argument type\",\n      errAddress: context.dependencyNode,\n    };\n  }\n\n  switch (result.result.type) {\n    case \"string\":\n      return result.result.value;\n    case \"number\":\n      // Convert number to string\n      if (result.result.value === Infinity) {\n        return \"INFINITY\";\n      } else if (result.result.value === -Infinity) {\n        return \"-INFINITY\";\n      } else if (isNaN(result.result.value)) {\n        return \"NaN\";\n      } else {\n        return result.result.value.toString();\n      }\n    case \"boolean\":\n      // Convert boolean to string\n      return result.result.value ? \"TRUE\" : \"FALSE\";\n    case \"infinity\":\n      return result.result.sign === \"positive\" ? \"INFINITY\" : \"-INFINITY\";\n    default:\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"Cannot convert argument to string\",\n        errAddress: context.dependencyNode,\n      };\n  }\n}\n\n/**\n * Helper function to perform CONCATENATE operation on evaluated arguments\n */\nfunction concatenateOperation(\n  textResults: FunctionEvaluationResult[],\n  context: EvaluationContext\n): { type: \"value\"; result: CellString } | ErrorEvaluationResult {\n  let result = \"\";\n  for (const textResult of textResults) {\n    const stringValue = coerceToString(textResult, context);\n    if (typeof stringValue === \"object\" && stringValue.type === \"error\") {\n      return stringValue;\n    }\n    result += stringValue;\n  }\n  return { type: \"value\", result: { type: \"string\", value: result } };\n}\n\n/**\n * Helper for creating spilled-values result for CONCATENATE function\n */\nfunction createConcatenateSpilledResult(\n  this: FormulaEvaluator,\n  {\n    textResults,\n    context,\n  }: {\n    textResults: FunctionEvaluationResult[];\n    context: EvaluationContext;\n  }\n): SpilledValuesEvaluationResult | ErrorEvaluationResult {\n  const spilledResults = textResults.filter(\n    (result) => result.type === \"spilled-values\"\n  );\n\n  if (spilledResults.length === 0) {\n    throw new Error(\n      \"createConcatenateSpilledResult called without spilled values\"\n    );\n  }\n\n  return {\n    type: \"spilled-values\",\n    spillArea: (origin: CellAddress): SpreadsheetRange => {\n      // Calculate spill area (union of all spilled ranges)\n      let spillArea: SpreadsheetRange | undefined;\n\n      for (const result of textResults) {\n        if (result.type === \"spilled-values\") {\n          const currentSpillArea = result.spillArea(origin);\n          if (!spillArea) {\n            spillArea = currentSpillArea;\n          } else {\n            spillArea = this.unionRanges(\n              this.projectRange(spillArea, origin),\n              this.projectRange(currentSpillArea, origin)\n            );\n          }\n        }\n      }\n\n      if (!spillArea) {\n        throw new Error(\"No spilled values found\");\n      }\n      return spillArea;\n    },\n    source: \"CONCATENATE with spilled values\",\n    evaluate: (spilledCell, evalContext): SingleEvaluationResult => {\n      // Evaluate all arguments at this spilled position\n      const spilledTextResults: FunctionEvaluationResult[] = [];\n\n      for (const textResult of textResults) {\n        if (textResult.type === \"spilled-values\") {\n          const spillResult = textResult.evaluate(spilledCell, evalContext);\n          if (spillResult === undefined) {\n            return {\n              type: \"error\",\n              err: FormulaError.REF,\n              message: \"The spilled results have not been evaluated\",\n              errAddress: context.dependencyNode,\n            };\n          }\n          if (spillResult.type === \"error\") {\n            return spillResult;\n          }\n          spilledTextResults.push(spillResult);\n        } else {\n          spilledTextResults.push(textResult);\n        }\n      }\n\n      return concatenateOperation(spilledTextResults, context);\n    },\n    evaluateAllCells: (intersectingRange) => {\n      throw new Error(\n        \"WIP: evaluateAllCells for CONCATENATE is not implemented\"\n      );\n    },\n  };\n}\n\n/**\n * CONCATENATE function implementation\n */\nexport const CONCATENATE: FunctionDefinition = {\n  name: \"CONCATENATE\",\n  evaluate: function (\n    node: FunctionNode,\n    context: EvaluationContext\n  ): FunctionEvaluationResult {\n    if (node.args.length < 1) {\n      return {\n        type: \"error\",\n        err: FormulaError.VALUE,\n        message: \"CONCATENATE function requires at least 1 argument\",\n        errAddress: context.dependencyNode,\n      };\n    }\n\n    // Evaluate all arguments\n    const textResults: FunctionEvaluationResult[] = [];\n    for (const arg of node.args) {\n      const result = this.evaluateNode(arg, context);\n      if (result.type === \"error\" || result.type === \"awaiting-evaluation\") {\n        return result;\n      }\n      textResults.push(result);\n    }\n\n    // Check if any arguments are spilled values\n    const hasSpilledValues = textResults.some(\n      (result) => result.type === \"spilled-values\"\n    );\n\n    if (hasSpilledValues) {\n      return createConcatenateSpilledResult.call(this, {\n        textResults,\n        context,\n      });\n    }\n\n    // All arguments are single values - type coercion will be handled in concatenateOperation\n\n    // Perform concatenation\n    return concatenateOperation(textResults, context);\n  },\n  aliases: [\"CONCAT\"],\n};\n"
   ],
-  "mappings": "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",
-  "debugId": "51EDA2D25EB87B1F64756E2164756E21",
+  "mappings": "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",
+  "debugId": "E486EB6FD50D339A64756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/formula-engine",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module"
 }

package/dist/types/core/commands/content-commands.d.ts

@@ -6,7 +6,7 @@
 import type { WorkbookManager } from "../managers/workbook-manager";
 import type { CopyManager } from "../managers/copy-manager";
 import type { CellAddress, CopyCellsOptions, RangeAddress, SerializedCellValue } from "../types";
-import type { EngineCommand, EngineAction } from "./types";
+import type { EngineCommand, EngineAction, MutationInvalidation } from "./types";
 /**
  * Command to set a single cell's content.
  */
@@ -17,9 +17,12 @@ export declare class SetCellContentCommand implements EngineCommand {
     readonly requiresReevaluation = true;
     private previousValue;
     private hadPreviousValue;
+    private executeFootprint;
+    private undoFootprint;
     constructor(workbookManager: WorkbookManager, address: CellAddress, newContent: SerializedCellValue);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -31,12 +34,15 @@ export declare class SetSheetContentCommand implements EngineCommand {
     private newContent;
     readonly requiresReevaluation = true;
     private previousContent;
+    private executeFootprint;
+    private undoFootprint;
     constructor(workbookManager: WorkbookManager, opts: {
         workbookName: string;
         sheetName: string;
     }, newContent: Map<string, SerializedCellValue>);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -47,9 +53,12 @@ export declare class ClearRangeCommand implements EngineCommand {
     private address;
     readonly requiresReevaluation = true;
     private clearedCells;
+    private executeFootprint;
+    private undoFootprint;
     constructor(workbookManager: WorkbookManager, address: RangeAddress);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -64,9 +73,13 @@ export declare class PasteCellsCommand implements EngineCommand {
     readonly requiresReevaluation = true;
     private targetSnapshots;
     private sourceSnapshots;
+    private executeFootprint;
+    private undoFootprint;
+    private executedContents;
     constructor(workbookManager: WorkbookManager, copyManager: CopyManager, source: CellAddress[], target: CellAddress, options: CopyCellsOptions);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -80,9 +93,13 @@ export declare class FillAreasCommand implements EngineCommand {
     private options;
     readonly requiresReevaluation = true;
     private targetSnapshots;
+    private executeFootprint;
+    private undoFootprint;
+    private executedContents;
     constructor(workbookManager: WorkbookManager, copyManager: CopyManager, seedRange: RangeAddress, targetRanges: RangeAddress[], options: CopyCellsOptions);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -96,9 +113,13 @@ export declare class MoveCellCommand implements EngineCommand {
     readonly requiresReevaluation = true;
     private sourceSnapshot;
     private targetSnapshot;
+    private executeFootprint;
+    private undoFootprint;
+    private executedContents;
     constructor(workbookManager: WorkbookManager, copyManager: CopyManager, source: CellAddress, target: CellAddress);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -112,9 +133,13 @@ export declare class MoveRangeCommand implements EngineCommand {
     readonly requiresReevaluation = true;
     private sourceSnapshots;
     private targetSnapshots;
+    private executeFootprint;
+    private undoFootprint;
+    private executedContents;
     constructor(workbookManager: WorkbookManager, copyManager: CopyManager, sourceRange: RangeAddress, target: CellAddress);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -132,11 +157,16 @@ export declare class AutoFillCommand implements EngineCommand {
     readonly requiresReevaluation = true;
     private previousContent;
     private previousMetadata;
+    private executeFootprint;
+    private undoFootprint;
+    private touchedAddresses;
+    private executedContents;
     constructor(workbookManager: WorkbookManager, styleManager: import("../managers/style-manager").StyleManager, autoFillManager: import("../autofill-utils").AutoFill, opts: {
         sheetName: string;
         workbookName: string;
     }, seedRange: import("../types").SpreadsheetRange, fillRanges: import("../types").SpreadsheetRange[], direction: import("@ricsam/selection-manager").FillDirection);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }

package/dist/types/core/commands/named-expression-commands.d.ts

@@ -6,7 +6,7 @@
 import type { NamedExpressionManager } from "../managers/named-expression-manager";
 import type { WorkbookManager } from "../managers/workbook-manager";
 import type { NamedExpression } from "../types";
-import type { EngineCommand, EngineAction } from "./types";
+import type { EngineCommand, EngineAction, MutationInvalidation } from "./types";
 /**
  * Dependencies needed for named expression commands.
  */
@@ -22,6 +22,8 @@ export declare class AddNamedExpressionCommand implements EngineCommand {
     private deps;
     private opts;
     readonly requiresReevaluation = true;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: NamedExpressionCommandDeps, opts: {
         expression: string;
         expressionName: string;
@@ -30,6 +32,7 @@ export declare class AddNamedExpressionCommand implements EngineCommand {
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -40,6 +43,8 @@ export declare class RemoveNamedExpressionCommand implements EngineCommand {
     private opts;
     readonly requiresReevaluation = true;
     private removedExpression;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: NamedExpressionCommandDeps, opts: {
         expressionName: string;
         sheetName?: string;
@@ -47,6 +52,7 @@ export declare class RemoveNamedExpressionCommand implements EngineCommand {
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -57,6 +63,8 @@ export declare class UpdateNamedExpressionCommand implements EngineCommand {
     private opts;
     readonly requiresReevaluation = true;
     private previousExpression;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: NamedExpressionCommandDeps, opts: {
         expression: string;
         expressionName: string;
@@ -65,6 +73,7 @@ export declare class UpdateNamedExpressionCommand implements EngineCommand {
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -74,6 +83,8 @@ export declare class RenameNamedExpressionCommand implements EngineCommand {
     private deps;
     private opts;
     readonly requiresReevaluation = true;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: NamedExpressionCommandDeps, opts: {
         expressionName: string;
         sheetName?: string;
@@ -82,6 +93,7 @@ export declare class RenameNamedExpressionCommand implements EngineCommand {
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -107,9 +119,12 @@ export declare class SetNamedExpressionsCommand implements EngineCommand {
     private opts;
     readonly requiresReevaluation = true;
     private previousExpressions;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: NamedExpressionCommandDeps, opts: SetNamedExpressionsOpts);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 export {};

package/dist/types/core/commands/structure-commands.d.ts

@@ -9,7 +9,7 @@ import type { ReferenceManager } from "../managers/reference-manager";
 import type { StyleManager } from "../managers/style-manager";
 import type { TableManager } from "../managers/table-manager";
 import type { WorkbookManager } from "../managers/workbook-manager";
-import type { EngineAction, EngineCommand } from "./types";
+import type { EngineAction, EngineCommand, MutationInvalidation } from "./types";
 /**
  * Dependencies needed for structure commands.
  */
@@ -38,9 +38,12 @@ export declare class AddWorkbookCommand implements EngineCommand {
     private deps;
     private workbookName;
     readonly requiresReevaluation = true;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: StructureCommandDeps, workbookName: string);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -51,9 +54,12 @@ export declare class RemoveWorkbookCommand implements EngineCommand {
     private workbookName;
     readonly requiresReevaluation = true;
     private snapshot;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: StructureCommandDeps, workbookName: string);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -64,9 +70,13 @@ export declare class RenameWorkbookCommand implements EngineCommand {
     private workbookName;
     private newWorkbookName;
     readonly requiresReevaluation = true;
+    private snapshot;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: StructureCommandDeps, workbookName: string, newWorkbookName: string);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -78,9 +88,12 @@ export declare class CloneWorkbookCommand implements EngineCommand {
     private fromWorkbookName;
     private toWorkbookName;
     readonly requiresReevaluation = true;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: StructureCommandDeps, fromWorkbookName: string, toWorkbookName: string);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -90,12 +103,15 @@ export declare class AddSheetCommand implements EngineCommand {
     private deps;
     private opts;
     readonly requiresReevaluation = true;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: StructureCommandDeps, opts: {
         workbookName: string;
         sheetName: string;
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -106,12 +122,15 @@ export declare class RemoveSheetCommand implements EngineCommand {
     private opts;
     readonly requiresReevaluation = true;
     private snapshot;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: StructureCommandDeps, opts: {
         workbookName: string;
         sheetName: string;
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -121,6 +140,9 @@ export declare class RenameSheetCommand implements EngineCommand {
     private deps;
     private opts;
     readonly requiresReevaluation = true;
+    private snapshot;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: StructureCommandDeps, opts: {
         workbookName: string;
         sheetName: string;
@@ -128,5 +150,6 @@ export declare class RenameSheetCommand implements EngineCommand {
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }

package/dist/types/core/commands/table-commands.d.ts

@@ -8,7 +8,7 @@ import type { NamedExpressionManager } from "../managers/named-expression-manage
 import type { WorkbookManager } from "../managers/workbook-manager";
 import type { SchemaManager } from "../managers/schema-manager";
 import type { CellAddress, SerializedCellValue, SpreadsheetRangeEnd, TableDefinition } from "../types";
-import type { EngineCommand, EngineAction } from "./types";
+import type { EngineCommand, EngineAction, MutationInvalidation } from "./types";
 /**
  * Dependencies needed for table commands.
  */
@@ -27,6 +27,8 @@ export declare class AddTableCommand implements EngineCommand {
     private deps;
     private props;
     readonly requiresReevaluation = true;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: TableCommandDeps, props: {
         tableName: string;
         sheetName: string;
@@ -37,6 +39,7 @@ export declare class AddTableCommand implements EngineCommand {
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -47,12 +50,15 @@ export declare class RemoveTableCommand implements EngineCommand {
     private opts;
     readonly requiresReevaluation = true;
     private removedTable;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: TableCommandDeps, opts: {
         tableName: string;
         workbookName: string;
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -64,9 +70,12 @@ export declare class RenameTableCommand implements EngineCommand {
     private oldName;
     private newName;
     readonly requiresReevaluation = true;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: TableCommandDeps, workbookName: string, oldName: string, newName: string);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -77,6 +86,8 @@ export declare class UpdateTableCommand implements EngineCommand {
     private opts;
     readonly requiresReevaluation = true;
     private previousTable;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: TableCommandDeps, opts: {
         tableName: string;
         sheetName?: string;
@@ -87,6 +98,7 @@ export declare class UpdateTableCommand implements EngineCommand {
     });
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }
 /**
@@ -97,8 +109,11 @@ export declare class ResetTablesCommand implements EngineCommand {
     private newTables;
     readonly requiresReevaluation = true;
     private previousTables;
+    private executeFootprint;
+    private undoFootprint;
     constructor(deps: TableCommandDeps, newTables: Map<string, Map<string, TableDefinition>>);
     execute(): void;
     undo(): void;
+    getInvalidationFootprint(phase: "execute" | "undo"): MutationInvalidation;
     toAction(): EngineAction;
 }